AmazonRekognitionClient.CreateDataset Method (CreateDatasetRequest)

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.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreateDatasetAsync.

Namespace: Amazon.Rekognition
Assembly: AWSSDK.Rekognition.dll
Version: 3.x.y.z

Syntax

public virtual CreateDatasetResponse CreateDataset(
         CreateDatasetRequest request
)

Parameters

request: Type: Amazon.Rekognition.Model.CreateDatasetRequest

Container for the necessary parameters to execute the CreateDataset service method.

Return Value

Type: CreateDatasetResponse

The response from the CreateDataset service method, as returned by Rekognition.

Exceptions

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.

Examples

Creates an Amazon Rekognition Custom Labels dataset with a manifest file stored in an Amazon S3 bucket.

To create an Amazon Rekognition Custom Labels dataset


var client = new AmazonRekognitionClient();
var response = client.CreateDataset(new CreateDatasetRequest 
{
    DatasetSource = new DatasetSource { GroundTruthManifest = new GroundTruthManifest { S3Object = new S3Object {
        Bucket = "my-bucket",
        Name = "datasets/flowers_training/manifests/output/output.manifest"
    } } },
    DatasetType = "TRAIN",
    ProjectArn = "arn:aws:rekognition:us-east-1:111122223333:project/my-project/1690474772815"
});

string datasetArn = response.DatasetArn;

Version Information

.NET Framework:
Supported in: 4.5 and newer, 3.5

AmazonRekognitionClient.CreateDataset (CreateDatasetRequest)

Method