ListCollections - 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á.

ListCollections

Retorna a lista de IDs de coleção em sua conta. Se o resultado for truncado, a resposta também fornece umNextTokenque pode ser usado na solicitação subsequente para buscar o próximo conjunto de IDs de coleção.

Para ver um exemplo, consulte Listar coleções.

Essa operação exige permissões para executar a ação rekognition:ListCollections.

Sintaxe da solicitação

{ "MaxResults": number, "NextToken": "string" }

Parâmetros de solicitação

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

MaxResults

Número máximo de IDs de coleção a serem retornados.

Type: Inteiro

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

: Não

NextToken

Token de paginação da resposta anterior.

Type: String

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

: Não

Sintaxe da resposta

{ "CollectionIds": [ "string" ], "FaceModelVersions": [ "string" ], "NextToken": "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.

CollectionIds

Uma matriz de IDs de coleção.

Type: Matriz de strings

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

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

FaceModelVersions

Números de versão dos modelos de detecção de rosto associados às coleções na matrizCollectionIds. Por exemplo, o valor deFaceModelVersions[2]é o número da versão para o modelo de detecção de rosto usado pela coleção emCollectionId[2].

Type: Matriz de strings

NextToken

Se o resultado for truncado, a resposta fornecerá umNextTokenque pode ser usado na solicitação subsequente para buscar o próximo conjunto de IDs de coleção.

Type: String

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

Erros

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

InvalidPaginationTokenException

O token de paginação na solicitação não é válido.

Código de status HTTP: 400

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: