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

DeleteFaces

Exclui faces de uma coleção. Você especifica um ID de coleção e uma matriz de IDs de face a serem removidas da coleção.

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

Sintaxe da solicitação

{ "CollectionId": "string", "FaceIds": [ "string" ] }

Parâmetros de solicitação

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

CollectionId

Coleção da qual remover as faces específicas.

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

FaceIds

Uma matriz de IDs faciais a serem excluídas.

Type: Matriz de strings

Membros da matriz: Número mínimo de 1 item. Número máximo de 4096 itens.

Padrão: [0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Obrigatório: Sim

Sintaxe da resposta

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

DeletedFaces

Uma matriz de cadeias de caracteres (IDs) das faces que foram excluídas.

Type: Matriz de strings

Membros da matriz: Número mínimo de 1 item. Número máximo de 4096 itens.

Padrão: [0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

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

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: