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.
This operation applies only to Amazon Rekognition Custom Labels.
Creates a new Amazon Rekognition Custom Labels dataset. You can create a dataset by using an Amazon Sagemaker format manifest file or by copying an existing Amazon Rekognition Custom Labels dataset.
To create a training dataset for a project, specify TRAIN for the value of
DatasetType. To create the test dataset for a project, specify TEST
for the value of DatasetType.
The response from CreateDataset is the Amazon Resource Name (ARN) for the dataset.
Creating a dataset takes a while to complete. Use DescribeDataset to check
the current status. The dataset created successfully if the value of Status
is CREATE_COMPLETE.
To check if any non-terminal errors occurred, call ListDatasetEntries and check
for the presence of errors lists in the JSON Lines.
Dataset creation fails if a terminal error occurs (Status = CREATE_FAILED).
Currently, you can't access the terminal error information.
For more information, see Creating dataset in the Amazon Rekognition Custom Labels Developer Guide.
This operation requires permissions to perform the rekognition:CreateDataset
action. If you want to copy an existing dataset, you also require permission to perform
the rekognition:ListDatasetEntries action.
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 BeginCreateDataset and EndCreateDataset.
Namespace: Amazon.Rekognition
Assembly: AWSSDK.Rekognition.dll
Version: 3.x.y.z
public virtual Task<CreateDatasetResponse> CreateDatasetAsync( CreateDatasetRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the CreateDataset 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. |
| InvalidS3ObjectException | Amazon Rekognition is unable to access the S3 object specified in the request. |
| LimitExceededException | An Amazon Rekognition service limit was exceeded. For example, if you start too many jobs concurrently, subsequent calls to start operations (ex: StartLabelDetection) will raise a LimitExceededException exception (HTTP status code: 400) until the number of concurrently running jobs is below the Amazon Rekognition service limit. |
| 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. |
| ResourceNotFoundException | The resource specified in the request cannot be found. |
| 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