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 umNextToken
que 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 matriz
CollectionIds
. 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á um
NextToken
que 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: