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

StartFaceSearch

Inicia a pesquisa assíncrona de faces em uma coleção que correspondem às faces de pessoas detectadas em um vídeo armazenado.

O vídeo deve ser armazenado em um bucket do Amazon S3. Usar oVideopara especificar o nome do bucket e o nome do arquivo do vídeo.StartFaceSearchretorna um identificador de trabalho (JobId) que você usa para obter os resultados de pesquisa após a conclusão da pesquisa. Quando a pesquisa estiver concluída, o Amazon Rekognition Video publica um status de conclusão no tópico do Amazon Simple Notification Service que você especificar noNotificationChannel. Para obter os resultados da pesquisa, primeiro verifique se o valor de status publicado no tópico do Amazon SNS éSUCCEEDED. Em caso afirmativo, ligueGetFaceSearche passar o identificador de trabalho (JobId) da chamada inicial paraStartFaceSearch. Para obter mais informações, consulte Pesquisando vídeos armazenados para rostos.

Sintaxe da solicitação

{ "ClientRequestToken": "string", "CollectionId": "string", "FaceMatchThreshold": number, "JobTag": "string", "NotificationChannel": { "RoleArn": "string", "SNSTopicArn": "string" }, "Video": { "S3Object": { "Bucket": "string", "Name": "string", "Version": "string" } } }

Parâmetros de solicitação

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

ClientRequestToken

Token idempotente usado para identificar a solicitação inicial. Se você usar o mesmo token com váriosStartFaceSearchsolicitações, o mesmoJobIdé retornado. Usar oClientRequestTokenpara evitar que o mesmo trabalho seja iniciado acidentalmente mais de uma vez.

Type: String

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

Padrão: ^[a-zA-Z0-9-_]+$

Obrigatório: Não

CollectionId

ID da coleção que contém as faces que você deseja pesquisar.

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

FaceMatchThreshold

A confiança mínima na pessoa corresponde ao retorno. Por exemplo, não retorne nenhuma correspondência em que a confiança nas partidas seja inferior a 70%. O valor padrão é de 80%.

Type: Float

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

Obrigatório: Não

JobTag

Um identificador especificado que é retornado na notificação de conclusão publicada no tópico do Amazon Simple Notification Service. Por exemplo, é possível usarJobTagpara agrupar trabalhos relacionados e identificá-los na notificação de conclusão.

Type: String

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

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

Obrigatório: Não

NotificationChannel

O ARN do tópico do Amazon SNS no qual você deseja que o Amazon Rekognition Video publique o status de conclusão da pesquisa. O tópico do Amazon SNS deve ter um nome de tópico que comece comAmazonRekognitionse você estiver usando a política de permissões AmazonRekognitionServiceRole para acessar o tópico.

Tipo: objeto NotificationChannel

Obrigatório: Não

Video

O vídeo que deseja pesquisar. O vídeo deve ser armazenado em um bucket do Amazon S3.

Tipo: objeto Video

Obrigatório: Sim

Sintaxe da resposta

{ "JobId": "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.

JobId

O identificador para o trabalho de pesquisa. Usar oJobIdpara identificar o trabalho em uma chamada subsequente paraGetFaceSearch.

Type: String

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

Padrão: ^[a-zA-Z0-9-_]+$

Errors

AccessDeniedException

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

Código de status HTTP: 400

IdempotentParameterMismatchException

UMAClientRequestTokenUm parâmetro de entrada foi reutilizado com uma operação, mas pelo menos um dos outros parâmetros de entrada é diferente da chamada anterior para a operaçã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

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

InvalidS3ObjectException

O Amazon Rekognition não pode acessar o objeto do S3 especificado na solicitação.

Código de status HTTP: 400

LimitExceededException

Um limite de serviço do Amazon Rekognition foi excedido. Por exemplo, se você iniciar muitos trabalhos do Amazon Rekognition Video simultaneamente, chamadas para iniciar operações (StartLabelDetection, por exemplo) levantará umLimitExceededExceptionExceção (código de status HTTP: 400) até que o número de trabalhos simultâneos fique abaixo do limite de serviço do Amazon Rekognition.

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

VideoTooLargeException

O tamanho do arquivo ou a duração da mídia fornecida é muito grande. O tamanho máximo do arquivo é de 10 GB. A duração máxima é de 6 horas.

Código de status HTTP: 400

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: