Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

describe_collection

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