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

ListFaces

Retorna metadados das faces na coleção especificada. Esses metadados incluem informações como as coordenadas da caixa delimitadora, a confiança (que a caixa delimitadora contém uma face) e o ID de face. Para ver um exemplo, consulte Listar faces em uma coleção.

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

Sintaxe da solicitação

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

Parâmetros de solicitação

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

CollectionId

ID da coleção a partir da qual listar os rostos.

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

MaxResults

O número máximo de faces a serem retornadas.

Type: Inteiro

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

: obrigatório Não

NextToken

Se a resposta anterior estiver incompleta (porque há mais dados a serem recuperados), o Amazon Rekognition retornará um token de paginação na resposta. Você pode usar esse token de paginação para recuperar o próximo conjunto de faces.

Type: String

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

: obrigatório Não

Sintaxe da resposta

{ "FaceModelVersion": "string", "Faces": [ { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Confidence": number, "ExternalImageId": "string", "FaceId": "string", "ImageId": "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.

FaceModelVersion

O número da versão do modelo de detecção de faces associado à coleção de entrada (CollectionId).

Type: String

Faces

Uma matriz de objetos Face.

Type: Matriz deFaceobjetos

NextToken

Se a resposta for truncada, o Amazon Rekognition retornará esse token que você pode usar na solicitação subsequente para recuperar o próximo conjunto de faces.

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

InvalidPaginationTokenException

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

Código de status HTTP: 400

InvalidParameterException

Um 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: