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á.
# Modificando cotas padrão no Amazon Textract
Sua conta do console tem cotas padrão para as operações do Amazon Textract. Esse é um conjunto de Region-specific cotas que você pode modificar. As cotas padrão podem ser visualizadas ou alteradas por meio do console Service Quotas. Você também pode visualizar as cotas padrão atuais do Amazon Textract nos endpoints e cotas de serviço do [Amazon Textract](https://docs.aws.amazon.com/general/latest/gr/textract.html).
## Tipos de cotas
Há dois tipos de cotas para o Amazon Textract.
+ Transações por segundo (TPS) (síncronas e assíncronas)
+ Trabalhos simultâneos (somente assíncronos)
+ Adaptadores
### TPS
As cotas do TPS determinam com que frequência você pode solicitar que o Textract processe um novo documento. As cotas de TPS são exclusivas para API, operações síncronas ou assíncronas e região.
#### TPS síncrono
As operações síncronas são usadas para processar documentos de uma única página e receber respostas quase em tempo real para Textract include AnalyzeDocument,, DetectDocumentText, AnalyzeExpense e AnalyzeID. Para obter mais informações, consulte [Processando documentos de forma síncrona](sync.md).
Para as seguintes APIs síncronas, Maximum Transactions Per Second (TPS) descreve o número máximo de transações (chamadas de API) que você pode realizar com sua conta em uma determinada região:
+ AnalyzeDocument
+ DetectDocumentText
+ AnalyzeExpense
+ ID de análise
#### TPS assíncrono
O Amazon Textract fornece operações assíncronas e não em tempo real para o processamento de documentos maiores e de várias páginas. Há dois tipos de operações de processamento assíncrono: operações de início e operações de obtenção. As operações Start são usadas para solicitar que o Textract processe um documento, enquanto as operações Get são usadas para obter o status e os resultados do processamento do documento. As cotas para as operações Start e Get são medidas no TPS. Para obter mais informações sobre processamento assíncrono, consulte. [Processando documentos de forma assíncrona](async.md)
A seguir, Start and Get APIs, Maximum Transactions Per Second (TPS) descreve o número máximo de transações (chamadas de API) que você pode realizar com sua conta em uma determinada região:
##### Início
+ StartDocumentAnalysis
+ StartDocumentTextDetection
+ StartExpenseAnalysis
##### Obtenção
+ GetDocumentAnalysis
+ GetDocumentTextDetection
+ GetExpenseAnalysis
### Trabalhos simultâneos
O limite de tarefas simultâneas define quantas tarefas podem ser executadas paralelamente em um determinado momento. Os limites do Concurrent Job se aplicam somente às operações assíncronas e são exclusivos às operações individuais.
As seguintes APIs têm cotas que definem o número máximo de trabalhos simultâneos que sua conta pode criar em uma determinada região:
+ AnalyzeDocument
+ DetectDocumentText
+ DetectDocumentExpense
### Adaptadores
As cotas do adaptador definem os seguintes limites para o treinamento do adaptador. Use o console do Service Quotas para solicitar um aumento de cota de serviço.
+ Número máximo de adaptadores - Número total de adaptadores permitidos. Você pode ter várias versões de adaptador em um único adaptador
+ Máximo AdapterVersions criado por mês — Número de versões bem-sucedidas do adaptador que podem ser criadas por conta da AWS por mês. Isso será redefinido no início de cada mês.
+ Máximo em andamento AdapterVersions (análogo ao treinamento do adaptador) por conta.
## Calcular o aumento da cota
O Amazon Textract tem uma Calculadora de [Cotas de Serviço específica do produto para estimar suas necessidades de cotas](https://console.aws.amazon.com/textract/home#/quotaCalculator). Você pode usar a Calculadora de Quotas do Textract Service para estimar os valores de cota que satisfarão seu caso de uso. Ele pode ser acessado pelo console do Amazon Textract. Esta seção descreverá o processo de cálculo de uma cota para atender às suas necessidades com a Calculadora de Cotas.
**Para usar a Calculadora de Quotas do Textract Service**
1. **Seleção de regiões**
Selecione a região da sua conta
A calculadora de serviços pode estimar cotas em qualquer região, e regiões diferentes têm cotas padrão diferentes. Dessa forma, certifique-se de combinar a região da sua conta com a região para a qual você está calculando. Se você quiser calcular uma cota para uma região diferente, altere primeiro a região da sua conta no console.
1. **Tipo de processamento**
Selecione *Síncrono ou *Assíncrono**.
As operações síncronas e assíncronas têm limites diferentes no Amazon Textract. Determine o tipo de operação que você mais pretende usar e selecione esse tipo de operação para os cálculos. Geralmente, as operações síncronas são usadas para processamento de documentos de uma única página, em que o processamento assíncrono abrange documentos de várias páginas.
Por exemplo, se seu caso de uso for processar recibos de clientes de uma única página, você selecionará Síncrono
1. **Tipo de caso de uso**
Selecione a operação mais adequada para seu caso de uso.
Operações diferentes extraem diferentes tipos de dados, então selecione a operação mais adequada ao seu caso de uso. Para obter mais informações sobre os dados extraídos por diferentes operações, consulte[Identificando seu caso de uso do Amazon Textract](how-it-works.md).
Por exemplo, se seu caso de uso estiver relacionado principalmente ao processamento de recibos, você selecionará *Análise de despesas* na lista de operações.
1. **Valores de uso**
Especifique seus valores de uso.
Ao determinar os requisitos, lembre-se do seu tipo de operação. Para operações síncronas, especifique o número máximo de páginas que você deseja processar em um determinado período de tempo, em horas ou dias.
**nota**
Para operações assíncronas, você também pode inserir o número esperado de horas que o processamento exigirá e o número médio de páginas nos documentos processados.
Por exemplo, se você processar uma média de um milhão de recibos por dia, você inserirá 1.000.000 na *guia Documentos a serem processados para* estimar o valor da cota necessária.
1. **Revise os resultados**
Verifique a etapa 3 da página da calculadora e revise a saída da calculadora. A calculadora extrai suas informações de cotas atuais e as compara com as cotas necessárias para seu caso de uso. Isso lhe dirá se suas cotas atuais são muito baixas para suas necessidades de processamento. Se for esse o caso, você pode clicar no link fornecido pela calculadora, que o vinculará diretamente a uma solicitação de aumento de cota para a operação estimada na região selecionada em Cotas de serviço.
**nota**
Se você estiver calculando para assíncrono, verá várias cotas estimadas. Você precisará clicar no link de cada cota para solicitar um aumento para cada uma, caso seja necessário.
Seguindo nosso exemplo ao longo dessas etapas, você precisaria de um TPS de 12 para processar todos os um milhão de recibos em um dia. Dessa forma, você precisará solicitar um aumento do TPS padrão de 5.
## Melhores práticas para solicitações de aumento de cota de serviço
Ao solicitar um aumento para uma cota padrão, há várias práticas recomendadas a serem seguidas. Isso inclui tráfego intenso e suave, configuração de novas tentativas e configuração de recuos e instabilidades exponenciais.
+ Estime seus valores de cota ideais usando a Calculadora de Cota do Textract Service.
+ Suavizando o tráfego intenso. 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.
+ Configure novas tentativas. Siga as diretrizes em [Tratamento de erros](https://docs.aws.amazon.com/textract/latest/dg/handling-errors.html) para configurar novas tentativas para os erros que as permitem
+ Configure o recuo exponencial e a instabilidade. Ao configurar o recuo exponencial e a instabilidade para novas tentativas, você pode melhorar a produtividade. Consulte Tentativas de [erro e recuo exponencial na AWS](https://docs.aws.amazon.com/general/latest/gr/api-retries.html).
+ Comece com amostras que aplicam as melhores práticas, como as [amostras de CDK do IDP usando construções de [CDK](https://github.com/aws-samples/amazon-textract-idp-cdk-constructs)](https://github.com/aws-samples/amazon-textract-idp-cdk-stack-samples).
## Alterar cota padrão
Como alternativa à geração de uma solicitação diretamente da calculadora, você também pode usar o console de cotas de serviço. Isso pode ser feito no [console de cotas de serviço](https://console.aws.amazon.com/servicequotas) e pode ser processado automaticamente. Em algumas circunstâncias, como um aumento particularmente grande, a solicitação será processada manualmente e informações adicionais poderão ser necessárias.
**Para aumentar uma solicitação de aumento de cota de serviço**
1. Faça login no Management Console, navegue até o [console de cotas de serviços](https://console.aws.amazon.com/servicequotas) e selecione “Textract” em serviços
1. Selecione a cota desejada e clique em “Solicitar aumento de cota” na página subsequente
1. Insira o valor da cota desejada e clique em “Solicitar”. Se você usou a Calculadora de Quotas de Serviço, você pode copiar o valor da cota de seus cálculos para a solicitação.
1. Depois de solicitar um aumento de cota, atualize a página para ver a atualização do status da cota.
**nota**
Alguns aumentos nos valores das cotas podem precisar de revisão manual.
## Efeitos de modificação de cota
A tabela a seguir lista os diferentes tipos de cotas e os efeitos que sua modificação terá.
| Valor da cota a ser aumentado | Efeito do aumento |
| --- | --- |
| Operação síncrona TPS | Aumenta a frequência com que você pode solicitar que o Textract processe um novo documento usando uma determinada operação síncrona, medida em transações por segundo |
| Operação de início assíncrono (TPS) | Aumenta a frequência com que você pode solicitar que o Textract inicie o processamento assíncrono de um documento de entrada, medido em transações por segundo |
| Assíncrono Obtenha a operação TPS | Aumenta a frequência com que você pode solicitar que o Textract retorne os resultados de um determinado trabalho de análise assíncrona, medidos em transações por segundo |
| Trabalhos simultâneos assíncronos | Aumenta o número total de documentos que você pode processar paralelamente. |