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ários
StartFaceSearchsolicitações, o mesmoJobIdO 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
-
Código 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, você pode usar
JobTagpara 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 você 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 o
JobIdpara 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-_]+$
Erros
- AccessDeniedException
-
Você não está autorizado a executar a ação.
Código de status HTTP: 400
- IdempotentParameterMismatchException
-
UMA
ClientRequestTokenUm 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 quiser 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:
