DescribeCollection - Amazon Rekognition

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

DescribeCollection

Descreve a coleção especificada. Você pode usarDescribeCollectionpara obter informações, como o número de faces indexadas em uma coleção e a versão do modelo usada pela coleção para detecção de rosto.

Para obter mais informações, consulte Descrição de uma coleção.

Sintaxe da solicitação

{ "CollectionId": "string" }

Parâmetros de solicitação

A solicitação aceita os dados a seguir no formato JSON.

CollectionId

O ID da coleção a ser descrita.

Type: String

Restrições de comprimento: Tamanho mínimo de 1. Tamanho máximo de 255.

Padrão: [a-zA-Z0-9_.\-]+

Obrigatório: Sim

Sintaxe da resposta

{ "CollectionARN": "string", "CreationTimestamp": number, "FaceCount": number, "FaceModelVersion": "string" }

Elementos de resposta

Se a ação for bem-sucedida, o serviço reenviará uma resposta HTTP 200.

Os seguintes dados são retornados no formato JSON pelo serviço.

CollectionARN

O nome de recurso da Amazon (ARN) da coleção.

Type: String

CreationTimestamp

O número de milissegundos desde o horário Unix até a criação da coleção. O horário epoch Unix é 00:00:00 UTC (Tempo Universal Coordenado), quinta-feira, 1° de janeiro de 1970.

Type: Time stamp

FaceCount

O número de faces que são indexados na coleção. Para indexar faces em uma coleção, useIndexFaces.

Type: Longo

Intervalo válido: Valor mínimo de 0.

FaceModelVersion

A versão do modelo de face usada pela coleção para detecção de face.

Para obter mais informações, consulte Versionamento de modelo.

Type: String

Errors

AccessDeniedException

Você não está autorizado a executar a ação.

Código de status HTTP: 400

InternalServerError

O Amazon Rekognition teve um problema de serviço. Tente fazer a chamada novamente.

Código de status HTTP: 500

InvalidParameterException

O parâmetro de entrada violou uma restrição. Valide seu parâmetro antes de chamar a operação de API novamente.

Código de status HTTP: 400

ProvisionedThroughputExceededException

O número de solicitações excedeu o limite da taxa de transferência. Se precisar aumentar esse limite, entre em contato com o Amazon Rekognition.

Código de status HTTP: 400

ResourceNotFoundException

O recurso especificado na solicitação não pode ser encontrado.

Código de status HTTP: 400

ThrottlingException

O Amazon Rekognition está temporariamente indisponível para processar a solicitação. Tente fazer a chamada novamente.

Código de status HTTP: 500

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte: