

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

# Diretrizes e cotas no Amazon Rekognition
<a name="limits"></a>

As seções a seguir fornecem diretrizes e cotas ao usar o Amazon Rekognition. Há dois tipos de cotas. *As cotas definidas*, como o tamanho máximo da imagem, não podem ser alteradas. As *Cotas padrão* listado na página [AWS Service Quotas](https://docs.aws.amazon.com/general/latest/gr/rekognition.html#limits_rekognition) pode ser alterada seguindo o procedimento descrito na seção [Cotas padrão](#changeable-quotas).

**Topics**
+ [Regiões compatíveis](#supported-regions)
+ [Definir cotas](#quotas)
+ [Cotas padrão](#changeable-quotas)

## Regiões compatíveis
<a name="supported-regions"></a>

Para obter uma lista das regiões da AWS em que o Amazon Rekognition está disponível, consulte [Regiões e Endpoints da AWS](https://docs.aws.amazon.com/general/latest/gr/rekognition.html) na *Referência geral do Amazon Web Services*.

## Definir cotas
<a name="quotas"></a>

A seguir está uma lista de limites no Amazon Rekognition que não podem ser alterados. Para obter informações sobre limites que você pode alterar, como limites de transações por segundo (TPS), consulte [Cotas padrão](#changeable-quotas). 

Para conhecer os limites de Amazon Rekognition Custom Labels, consulte [Diretrizes e cotas em Amazon Rekognition Custom Labels](https://docs.aws.amazon.com/rekognition/latest/customlabels-dg/limits.html).

### Amazon Rekognition Image
<a name="limits-image"></a>
+ O tamanho máximo da imagem armazenada como um objeto do Amazon S3 é limitado a 15 MB. 
+ A dimensão máxima da imagem para `DetectModerationLabels` é de 10K pixels para largura e altura.
+ A dimensão máxima da imagem para `DetectLabels` é de 10K pixels para largura e altura.
+ Para ser detectado, um rosto não deve ser menor do que 40 x 40 pixels em uma imagem com resolução de 1920 x 1080 pixels. Imagens com dimensões maiores do que 1920 x 1080 pixels precisam de um tamanho mínimo de face proporcionalmente maior. 
+ As dimensões mínimas da imagem são 80 pixels para altura e largura. A dimensão mínima da imagem para `DetectProtectiveEquipment` é de 64 pixels para altura e largura. 
+ A dimensão máxima da imagem `DetectProtectiveEquipment` é de 4096 pixels para largura e altura.
+ Para ser detectada por `DetectProtectiveEquipment`, uma pessoa não deve ter menos de 100x100 pixels em uma imagem com 800x1300. Imagens com dimensões superiores a 800x1300 pixels precisarão de um tamanho mínimo de pessoa maior proporcionalmente. 
+ O tamanho máximo das imagens como bytes brutos passados como parâmetro para uma API é de 5 MB. O limite é de 4 MB para a API `DetectProtectiveEquipment`.
+ O Amazon Rekognition oferece suporte aos formatos de imagem PNG e JPEG. Ou seja, as imagens fornecidas por você como entrada para diversas operações de API, como `DetectLabels` e `IndexFaces` devem estar em um dos formatos compatíveis.
+ O número máximo de vetores faciais que você pode armazenar em uma única coleção de faces é de 20 milhões.
+ O número máximo padrão de vetores de usuário que você pode armazenar em uma única coleção de faces é 10 milhões.
+ O máximo de vetores faciais correspondentes que a API de pesquisa retorna é 4096.
+ O máximo de vetores de usuário correspondentes que a API de pesquisa retorna é 4096.
+ `DetectText` pode detectar até 100 palavras em uma imagem.
+ `DetectProtectiveEquipment` pode detectar equipamentos de proteção individual em até 15 pessoas.

Para obter informações sobre as melhores práticas para imagens e comparação facial, consulte [Melhores práticas para sensores, imagens de entrada e vídeos](best-practices.md).

### Análise em massa do Amazon Rekognition Image
<a name="limits-image"></a>
+ A análise em massa do Amazon Rekognition Image pode analisar lotes de imagens com um tamanho de até 10 mil imagens.
+ A análise em massa do Amazon Rekognition Image é compatível com manifestos de entrada com um tamanho de até 50 MB.

### Vídeo armazenado no Amazon Rekognition Video
<a name="limits-vstored-video"></a>
+ O Amazon Rekognition Video pode analisar vídeos armazenados de até 10 GB.
+ O Amazon Rekognition Video pode analisar vídeos armazenados com até 6 horas de duração.
+ O Amazon Rekognition Video suporta no máximo 20 trabalhos simultâneos por conta.
+ Os vídeos armazenados devem ser codificados usando o codec H.264. Os formatos de arquivo compatíveis são MPEG-4 e MOV.
+ Qualquer API do Amazon Rekognition Video que analise dados de áudio só oferece suporte a codecs de áudio AAC.
+ O período de vida útil (TTL – Time To Live) para tokens de paginação é de 24 horas. Os tokens de paginação tokens estão no campo `NextToken` retornado por operações Get, como `GetLabeldetection`.

### Streaming de vídeo com o Amazon Rekognition Video
<a name="limits-streaming-video"></a>
+ Um stream de entrada do Kinesis Video pode ser associado a no máximo 1 processador de stream do Amazon Rekognition Video.
+ Um stream de saída do Kinesis Data pode ser associado a no máximo 1 processador de stream do Amazon Rekognition Video. 
+ O stream de entrada do Kinesis Video e o stream de saída do Kinesis Data associados a um processador de stream do Amazon Rekognition Video não podem ser compartilhados por vários processadores.
+ Qualquer API do Amazon Rekognition Video que analise dados de áudio só oferece suporte a codecs de áudio ACC.

## Cotas padrão
<a name="changeable-quotas"></a>

Uma lista de cotas padrão pode ser encontrada em [Service Quotas da AWS](https://docs.aws.amazon.com/general/latest/gr/rekognition.html#limits_rekognition). Esses limites são padrões e podem ser alterados. Para solicitar um aumento de limite, você cria um caso. Para ver seus limites de cota atuais (valores de cota aplicados), consulte [Service Quotas do Amazon Rekognition](https://us-west-2.console.aws.amazon.com/servicequotas/home/services/rekognition/quotas). Para visualizar seu histórico de utilização de TPS para [APIs do Amazon Rekognition Image](https://docs.aws.amazon.com/rekognition/latest/dg/API_Reference.html), consulte a página [Service Quotas do Amazon Rekognition](https://us-west-2.console.aws.amazon.com/servicequotas/home/services/rekognition/quotas) e escolha uma operação de API específica para ver o histórico dessa operação. 

**Topics**
+ [Calcular a alteração da cota de TPS](#quotas-calculating)
+ [Melhores práticas para cotas de TPS](#quotas-best-practices)
+ [Crie um caso para alterar as cotas de TPS](#quotas-create-case)

### Calcular a alteração da cota de TPS
<a name="quotas-calculating"></a>

Qual é o novo limite que você está solicitando? As transações por segundo (TPS) são mais relevantes no pico de uma workload esperada. É importante entender o máximo de chamadas de API simultâneas no pico de uma workload e o tempo de resposta (5 a 15 segundos). Observe que 5 segundos deve ser o mínimo. Abaixo estão dois exemplos:
+ Exemplo 1: O número máximo de usuários simultâneos de Autenticação Facial (API CompareFaces) que espero no início do meu horário mais movimentado é 1000. Essas respostas serão distribuídas por um período de 10 segundos. Portanto, o TPS exigido é 100 (1000/10) para a API CompareFaces na minha região relevante.
+ Exemplo 2: O número máximo de chamadas simultâneas de Detecção de Objetos (API DetectLabels) que são esperadas no início do meu horário mais movimentado é 250. Essas respostas serão distribuídas por um período de 5 segundos. Portanto, o TPS exigido é 50 (250/5) para a API DetectLabels na minha região relevante.

### Melhores práticas para cotas de TPS
<a name="quotas-best-practices"></a>

As melhores práticas recomendadas para transações por segundo (TPS) incluem atenuar picos de tráfego, configurar novas tentativas e configurar recuo exponencial e instabilidade.

1. Tráfego suave e pontiagudo. O tráfego intenso afeta a throughput. Para obter a máxima de throughput para as transações alocadas por segundo (TPS), use uma arquitetura sem servidor de filas ou outro mecanismo para "suavizar" o tráfego e torná-lo mais consistente. Para exemplos de código e referências para processamento de imagens e vídeos em grande escala sem servidor com o Rekognition, consulte [Processamento de imagens e vídeos em grande escala com o Amazon Rekognition](https://github.com/aws-samples/amazon-rekognition-serverless-large-scale-image-and-video-processing). 

1. Configure novas tentativas. Siga as diretrizes em [Tratamento de erros](error-handling.md) para configurar novas tentativas para os erros que as permitem.

1. Configure o recuo exponencial e a instabilidade. Configurar o recuo exponencial e a instabilidade ao configurar novas tentativas permite melhorar o throughput que pode ser alcançado. Consulte [Tentativas de erro e recuo exponencial na AWS](https://docs.aws.amazon.com/general/latest/gr/api-retries.html).

### Crie um caso para alterar as cotas de TPS
<a name="quotas-create-case"></a>

Para criar um caso, acesse [Criar caso](https://console.aws.amazon.com/support/v1#/case/create?issueType=service-limit-increase) e responda às seguintes perguntas: 
+ Você implementou o [Melhores práticas para cotas de TPS](#quotas-best-practices) para suavizar seus picos de tráfego e configurar novas tentativas, recuo exponencial e instabilidade? 
+ Você calculou a alteração de cota de TPS de que precisa? Se não, consulte [Calcular a alteração da cota de TPS](#quotas-calculating).
+ Você verificou seu histórico de uso do TPS para prever com mais precisão suas necessidades futuras? Para visualizar seu histórico de uso do TPS, consulte a página [Service Quotas do Amazon Rekognition](https://us-west-2.console.aws.amazon.com/servicequotas/home/services/rekognition/quotas).
+ Qual é o seu caso de uso?
+ Quais APIs você planeja usar?
+ Em quais regiões você planeja usar essas APIs?
+ Você é capaz de distribuir a carga em várias regiões?
+ Quantas imagens você processa diariamente?
+ Por quanto tempo você espera manter esse volume (é um pico único ou contínuo)?
+ Como você é bloqueado pelo limite padrão? Examine a tabela de exceções a seguir para confirmar o cenário que você está enfrentando.    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/rekognition/latest/dg/limits.html)

  Para obter uma compreensão detalhada dos códigos de erro, consulte [Tratamento de erros](error-handling.md).

**nota**  
Esses limites dependem da região em que você está. Fazer um caso para alterar um limite afeta a operação de API que você solicita, na região em que você a solicita. Outras operações e regiões da API não são afetadas.