AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Creates a collection in an AWS Region. You can add faces to the collection using the IndexFaces operation.
For example, you might create collections, one for each of your application users.
A user can then index faces using the IndexFaces operation and persist results
in a specific collection. Then, a user can search the collection for faces in the
user-specific container.
When you create a collection, it is associated with the latest version of the face model version.
Collection names are case-sensitive.
This operation requires permissions to perform the rekognition:CreateCollection
action. If you want to tag your collection, you also require permission to perform
the rekognition:TagResource operation.
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginCreateCollection and EndCreateCollection.
Namespace: Amazon.Rekognition
Assembly: AWSSDK.Rekognition.dll
Version: 3.x.y.z
public virtual Task<CreateCollectionResponse> CreateCollectionAsync( CreateCollectionRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the CreateCollection service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
| Exception | Condition |
|---|---|
| AccessDeniedException | You are not authorized to perform the action. |
| InternalServerErrorException | Amazon Rekognition experienced a service issue. Try your call again. |
| InvalidParameterException | Input parameter violated a constraint. Validate your parameter before calling the API operation again. |
| ProvisionedThroughputExceededException | The number of requests exceeded your throughput limit. If you want to increase this limit, contact Amazon Rekognition. |
| ResourceAlreadyExistsException | A resource with the specified ID already exists. |
| ServiceQuotaExceededException | The size of the collection exceeds the allowed limit. For more information, see Guidelines and quotas in Amazon Rekognition in the Amazon Rekognition Developer Guide. |
| ThrottlingException | Amazon Rekognition is temporarily unable to process the request. Try your call again. |
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer