Rekognition / Client / describe_collection

describe_collection#

Rekognition.Client.describe_collection(**kwargs)#

Describes the specified collection. You can use DescribeCollection to get information, such as the number of faces indexed into a collection and the version of the model used by the collection for face detection.

For more information, see Describing a Collection in the Amazon Rekognition Developer Guide.

See also: AWS API Documentation

Request Syntax

response = client.describe_collection(
    CollectionId='string'
)
Parameters:

CollectionId (string) –

[REQUIRED]

The ID of the collection to describe.

Return type:

dict

Returns:

Response Syntax

{
    'FaceCount': 123,
    'FaceModelVersion': 'string',
    'CollectionARN': 'string',
    'CreationTimestamp': datetime(2015, 1, 1)
}

Response Structure

  • (dict) –

    • FaceCount (integer) –

      The number of faces that are indexed into the collection. To index faces into a collection, use IndexFaces.

    • FaceModelVersion (string) –

      The version of the face model that’s used by the collection for face detection.

      For more information, see Model versioning in the Amazon Rekognition Developer Guide.

    • CollectionARN (string) –

      The Amazon Resource Name (ARN) of the collection.

    • CreationTimestamp (datetime) –

      The number of milliseconds since the Unix epoch time until the creation of the collection. The Unix epoch time is 00:00:00 Coordinated Universal Time (UTC), Thursday, 1 January 1970.

Exceptions

  • Rekognition.Client.exceptions.InvalidParameterException

  • Rekognition.Client.exceptions.AccessDeniedException

  • Rekognition.Client.exceptions.InternalServerError

  • Rekognition.Client.exceptions.ThrottlingException

  • Rekognition.Client.exceptions.ProvisionedThroughputExceededException

  • Rekognition.Client.exceptions.ResourceNotFoundException