Diretrizes e cotas no Amazon Rekognition - 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á.

Diretrizes e cotas no Amazon Rekognition

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 pode ser alterada seguindo o procedimento descrito na seção Cotas padrão.

Regiões com suporte

Para obter uma lista das AWS regiões em que o Amazon Rekognition está disponível, consulte Regiões e endpoints da AWS na Referência geral da Amazon Web Services.

Definir cotas

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.

Para conhecer os limites de Amazon Rekognition Custom Labels, consulte Diretrizes e cotas em Amazon Rekognition Custom Labels.

Imagem do Amazon Rekognition

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

Análise em massa de imagens do Amazon Rekognition

  • O Amazon Rekognition Image Bulk Analysis pode analisar lotes de imagens de até 10.000 imagens de tamanho.

  • A análise em massa de imagens do Amazon Rekognition suporta manifestos de entrada de até 50 MB de tamanho.

Vídeo armazenado no Amazon Rekognition Video

  • 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 suportados 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

  • 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

Uma lista de cotas padrão pode ser encontrada em Service Quotas da AWS. 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. Para visualizar seu histórico de utilização de TPS para APIs de imagem do Amazon Rekognition, consulte a página Service Quotas do Amazon Rekognition e escolha uma operação de API específica para ver o histórico dessa operação.

Calcular a alteração da cota de TPS

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 (CompareFaces API) que eu espero no início do meu horário mais movimentado é de 1000. Essas respostas serão distribuídas por um período de 10 segundos. Portanto, o TPS necessário é 100 (1000/10) para a CompareFaces API na minha região relevante.

  • Exemplo 2: O máximo de chamadas simultâneas de Detecção de Objetos (DetectLabels API) 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 necessário é 50 (250/5) para a DetectLabels API na minha região relevante.

Melhores práticas para cotas de TPS

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.

  2. Configure novas tentativas. Siga as diretrizes em Tratamento de erros para configurar novas tentativas para os erros que as permitem.

  3. 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 em. AWS

Crie um caso para alterar as cotas de TPS

Para criar um caso, acesse Criar caso e responda às seguintes perguntas:

  • Você implementou o Melhores práticas para cotas de TPS 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.

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

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

    Código de erro Exceção Message O que isso significa? Pode ser tentado novamente?
    Código de status HTTP 400

    ProvisionedThroughputExceededException

    Taxa provisionada excedida.

    Indica controle de utilização. Você pode tentar novamente ou avaliar uma solicitação de aumento de limite.

    Sim

    Código de status HTTP 400

    ThrottlingException

    Diminuir a velocidade; aumento repentino na taxa de solicitações.

    Você pode estar enviando tráfego intenso e usar o controle de utilização. Você deve moldar o tráfego e torná-lo mais suave e consistente. Em seguida, configure novas tentativas. Consulte as melhores práticas. Sim
    Código de status HTTP 5xx ThrottlingException (HTTP 500) Serviço indisponível

    Indica que o back-end está sendo ampliado para dar suporte à ação. Você deve tentar fazer a solicitação novamente.

    Sim

    Para obter uma compreensão detalhada dos códigos de erro, consulte Tratamento de erros.

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.