Comprehend / Client / list_datasets

list_datasets

Comprehend.Client.list_datasets(**kwargs)

List the datasets that you have configured in this Region. For more information about datasets, see Flywheel overview in the Amazon Comprehend Developer Guide.

See also: AWS API Documentation

Request Syntax

response = client.list_datasets(
    FlywheelArn='string',
    Filter={
        'Status': 'CREATING'|'COMPLETED'|'FAILED',
        'DatasetType': 'TRAIN'|'TEST',
        'CreationTimeAfter': datetime(2015, 1, 1),
        'CreationTimeBefore': datetime(2015, 1, 1)
    },
    NextToken='string',
    MaxResults=123
)

Parameters:

• FlywheelArn (string) – The Amazon Resource Number (ARN) of the flywheel.

• Filter (dict) –

  Filters the datasets to be returned in the response.

  • Status (string) –

    Filter the datasets based on the dataset status.

  • DatasetType (string) –

    Filter the datasets based on the dataset type.

  • CreationTimeAfter (datetime) –

    Filter the datasets to include datasets created after the specified time.

  • CreationTimeBefore (datetime) –

    Filter the datasets to include datasets created before the specified time.

• NextToken (string) – Identifies the next page of results to return.

• MaxResults (integer) – Maximum number of results to return in a response. The default is 100.

Return type:

dict

Returns:

Response Syntax

{
    'DatasetPropertiesList': [
        {
            'DatasetArn': 'string',
            'DatasetName': 'string',
            'DatasetType': 'TRAIN'|'TEST',
            'DatasetS3Uri': 'string',
            'Description': 'string',
            'Status': 'CREATING'|'COMPLETED'|'FAILED',
            'Message': 'string',
            'NumberOfDocuments': 123,
            'CreationTime': datetime(2015, 1, 1),
            'EndTime': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

• (dict) –

  • DatasetPropertiesList (list) –

    The dataset properties list.

    • (dict) –

      Properties associated with the dataset.

      • DatasetArn (string) –

        The ARN of the dataset.

      • DatasetName (string) –

        The name of the dataset.

      • DatasetType (string) –

        The dataset type (training data or test data).

      • DatasetS3Uri (string) –

        The S3 URI where the dataset is stored.

      • Description (string) –

        Description of the dataset.

      • Status (string) –

        The dataset status. While the system creates the dataset, the status is CREATING. When the dataset is ready to use, the status changes to COMPLETED.

      • Message (string) –

        A description of the status of the dataset.

      • NumberOfDocuments (integer) –

        The number of documents in the dataset.

      • CreationTime (datetime) –

        Creation time of the dataset.

      • EndTime (datetime) –

        Time when the data from the dataset becomes available in the data lake.

  • NextToken (string) –

    Identifies the next page of results to return.

Exceptions

• Comprehend.Client.exceptions.InvalidRequestException

• Comprehend.Client.exceptions.TooManyRequestsException

• Comprehend.Client.exceptions.InvalidFilterException

• Comprehend.Client.exceptions.ResourceNotFoundException

• Comprehend.Client.exceptions.InternalServerException