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.StartFaceSearch
retorna 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
StartFaceSearch
solicitações, o mesmoJobId
O retornado. Usar oClientRequestToken
para 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
JobTag
para 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
JobId
para 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
ClientRequestToken
Um 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á umLimitExceededException
Exceçã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: