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

CreateCollection

Cria uma coleção em uma região da AWS. É possível adicionar faces à coleção usando oIndexFacesoperação.

Por exemplo, você pode criar coleções, uma para cada um dos usuários do aplicativo. Um usuário pode então indexar faces usando oIndexFacesoperação e persistir resultados em uma coleção específica. Em seguida, um usuário pode pesquisar rostos na coleção no contêiner específico do usuário.

Ao criar uma coleção, ela é associada à versão mais recente da versão do modelo de faces.

nota

Os nomes das coleções diferenciam maiúsculas.

Essa operação exige permissões para executar a ação rekognition:CreateCollection. Se você quiser marcar sua coleção, você também precisa de permissão para executar orekognition:TagResourceoperação.

Sintaxe da solicitação

{ "CollectionId": "string", "Tags": { "string" : "string" } }

Parâmetros de solicitação

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

CollectionId

ID da coleção que você está criando.

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

Tags

Um conjunto de chaves (pares chave-valor) que você quer associar à coleção.

Type: Mapa de string para string

Entradas do mapa: Número máximo de 0 itens. Número máximo de 200 itens.

Restrições de comprimento da chave: Tamanho mínimo de 1. Tamanho máximo de 128.

Padrão da chave: ^(?!aws:)[\p{L}\p{Z}\p{N}_.:/=+\-@]*$

Restrições de tamanho do valor: Tamanho mínimo de 0. Tamanho máximo de 256.

Padrão de valor:^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

: obrigatório Não

Sintaxe da resposta

{ "CollectionArn": "string", "FaceModelVersion": "string", "StatusCode": number }

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.

CollectionArn

Nome de recurso da Amazon (ARN) da coleção. Você pode usar isso para gerenciar permissões em seus recursos.

Type: String

FaceModelVersion

Número da versão do modelo de detecção de rosto associado à coleção que você está criando.

Type: String

StatusCode

Código de status HTTP indicando o resultado da operação.

Type: Inteiro

Intervalo válido Valor mínimo de 0.

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

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

ResourceAlreadyExistsException

Um recurso com o ID especificado já existe.

Código de status HTTP: 400

ServiceQuotaExceededException

O tamanho do recurso excede o limite permitido. Para obter mais informações, consulte Diretrizes e cotas no Amazon Rekognition.

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: