Rekognition / Client / distribute_dataset_entries

distribute_dataset_entries#

Rekognition.Client.distribute_dataset_entries(**kwargs)#

Note

This operation applies only to Amazon Rekognition Custom Labels.

Distributes the entries (images) in a training dataset across the training dataset and the test dataset for a project. DistributeDatasetEntries moves 20% of the training dataset images to the test dataset. An entry is a JSON Line that describes an image.

You supply the Amazon Resource Names (ARN) of a project’s training dataset and test dataset. The training dataset must contain the images that you want to split. The test dataset must be empty. The datasets must belong to the same project. To create training and test datasets for a project, call CreateDataset.

Distributing a dataset takes a while to complete. To check the status call DescribeDataset. The operation is complete when the Status field for the training dataset and the test dataset is UPDATE_COMPLETE. If the dataset split fails, the value of Status is UPDATE_FAILED.

This operation requires permissions to perform the rekognition:DistributeDatasetEntries action.

See also: AWS API Documentation

Request Syntax

response = client.distribute_dataset_entries(
    Datasets=[
        {
            'Arn': 'string'
        },
    ]
)
Parameters:

Datasets (list) –

[REQUIRED]

The ARNS for the training dataset and test dataset that you want to use. The datasets must belong to the same project. The test dataset must be empty.

  • (dict) –

    A training dataset or a test dataset used in a dataset distribution operation. For more information, see DistributeDatasetEntries.

    • Arn (string) – [REQUIRED]

      The Amazon Resource Name (ARN) of the dataset that you want to use.

Return type:

dict

Returns:

Response Syntax

{}

Response Structure

  • (dict) –

Exceptions

  • Rekognition.Client.exceptions.ResourceNotFoundException

  • Rekognition.Client.exceptions.InvalidParameterException

  • Rekognition.Client.exceptions.AccessDeniedException

  • Rekognition.Client.exceptions.InternalServerError

  • Rekognition.Client.exceptions.ThrottlingException

  • Rekognition.Client.exceptions.ProvisionedThroughputExceededException

  • Rekognition.Client.exceptions.ResourceNotReadyException