

# Cotas para configurar e executar uma API REST no API Gateway
<a name="api-gateway-execution-service-limits-table"></a>

As cotas a seguir se aplicam à configuração e à execução de uma API REST no Amazon API Gateway. Se a cota for por API, ela só poderá ser aumentada em APIs específicas, não em todas as APIs em uma conta.

Para ter informações sobre cotas em nível de conta, consulte [Cotas do Amazon API Gateway](limits.md).


| Recurso ou operação | Cota padrão | Pode ser aumentada | 
| --- | --- | --- | 
| Nomes de domínio personalizados públicos por conta e por região | 120 | [Sim](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-A93447B8) | 
| Nomes de domínio personalizados privados por conta e por região | 50 | [Sim](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-24E7E662) | 
| APIs regionais por região | 600 | Não | 
| APIs otimizadas para borda por região | 120 | Não | 
| APIs privadas por conta e por região | 600 | Não | 
| Associações de acesso a nomes de domínio por conta | 100 | [Sim](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-4D98A8A5) | 
| Mapeamentos de API de vários níveis por domínio | 200 | Não | 
| Regras de roteamento por domínio | 50 | [Sim](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-68B79FF0) | 
| Quantidade de caracteres do URL de uma API otimizada para a borda | 8192 | Não | 
| Quantidade de caracteres do URL de uma API regional | 10240 | Não | 
| Quantidade de caracteres do URL de uma API regional | 8192 | Não | 
| Quantidade de caracteres da política de recursos do API Gateway | 8192 | [Sim](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-8B81B02C) | 
| Chaves de API por conta por região | 10000 | Não | 
| Certificados de cliente por conta por região | 60 | [Sim](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-824C9E42) | 
| Autorizadores por API (AWS Lambda e Amazon Cognito) | 10 |  Sim Para aumentar essa cota, entre em contato com o [AWS Support Center](https://console.aws.amazon.com/support/home#/).  | 
| Partes da documentação por API | 2000 |  Sim Para aumentar essa cota, entre em contato com o [AWS Support Center](https://console.aws.amazon.com/support/home#/).  | 
| Recursos por API | 300 | [Sim](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-01C8A9E0) | 
| Estágios por API | 10 | [Sim](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-379E48B0) | 
| Variáveis de estágio por estágio | 100 | Não | 
| Quantidade de caracteres da chave em uma variável de estágio | 64 | Não | 
| Quantidade de caracteres do valor em uma variável de estágio | 512 | Não | 
| Planos de uso por conta por região | 300 | [Sim](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E8693075) | 
| Planos de uso por chave de API | 10 | [Sim](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-985EB478) | 
| Links de VPC por conta por região | 20 | [Sim](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-A4C7274F) | 
| TTL de armazenamento em cache de APIs | 300 segundos por padrão e configurável entre 0 e 3600 por um proprietário de API. | Não para o limite superior (3600) | 
| Tamanho de resposta em cache | 1048576 bytes. A criptografia de dados de cache pode aumentar o tamanho do item que está sendo armazenado em cache. | Não | 
| Tempo limite de integração para APIs regionais | 50 milissegundos a 29 segundos para todos os tipos de integração, incluindo integrações do Lambda, proxy do Lambda, HTTP, proxy HTTP e AWS. | [Sim \$1](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E5AE38E3) | 
| Tempo limite de integração para APIs otimizadas para borda | 50 milissegundos a 29 segundos para todos os tipos de integração, incluindo integrações do Lambda, proxy do Lambda, HTTP, proxy HTTP e AWS. | Não | 
| Tempo limite de integração para APIs privadas | 50 milissegundos a 29 segundos para todos os tipos de integração, incluindo integrações do Lambda, proxy do Lambda, HTTP, proxy HTTP e AWS. | [Sim \$1](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E5AE38E3) | 
| Tamanho total combinado de todos os valores de cabeçalho, incluindo nomes de cabeçalho, valores, quaisquer terminadores de linha e espaços em branco | 10240 bytes | Não | 
| Tamanho total combinado de todos os valores do cabeçalho para uma API privada | 8.000 bytes | Não | 
| Tamanho da carga útil | 10 MB | Não | 
| Tags por estágio | 50 | Não | 
| Número de iterações em um loop \$1foreach ... \$1end em modelos de mapeamento | 1000 | Não | 
| Tamanho máximo do modelo de mapeamento | 300 KB | Não | 
| Tamanho do modelo de log de acesso | 3 KB | Não | 
| Comprimento do ARN do método | 1.600 bytes. Se seu método contiver um parâmetro de caminho e um cliente usar um valor que exceda o comprimento do ARN, a API exibirá a resposta 414 Request URI too long. | Não | 
| Configurações do controle de utilização em nível de método para um estágio em um plano de utilização | 20 |  Sim Para aumentar essa cota, entre em contato com o [AWS Support Center](https://console.aws.amazon.com/support/home#/).  | 
| Tamanho do modelo por API | 400 KB | Não | 
| Número de certificados em um armazenamento de confiança | Mil certificados com até 1 MB de tamanho total do objeto. | Não | 
| Tempo limite de inatividade da conexão | 310 segundos | Não | 
| Tamanho máximo do arquivo de definição de API ao usar [restapi:import](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportRestApi.html) ou [restapi:put](https://docs.aws.amazon.com/apigateway/latest/api/API_PutRestApi.html) | 6 MB | Não | 

\$1 Não é possível definir o tempo limite de integração para menos de 50 milissegundos. Você pode aumentar o tempo limite de integração para mais de 29 segundos, mas isso pode exigir uma redução na cota de controle de utilização no nível de região da sua conta.

## Práticas recomendadas para reduzir cotas
<a name="api-gateway-execution-service-limits-best-practices"></a>

As práticas recomendadas a seguir podem ajudar a reduzir o número atual de recursos para evitar o aumento da cota. Verifique se essas sugestões funcionam para a arquitetura da sua API.

**APIs por região**  
Para reduzir o número de APIs por região, exporte todas as APIs não utilizadas e exclua-as do API Gateway. Para obter mais informações, consulte [Exportar uma API REST do API Gateway](api-gateway-export-api.md).

**Estágios por API**  
Para reduzir o número de estágios por API, divida a API em várias APIs.

**Recursos por API**  
Use caminhos `{proxy+}` para reduzir o número de recursos. Para obter mais informações, consulte [Configurar a integração de proxy com um recurso de proxy](api-gateway-set-up-simple-proxy.md).

**Mapeamentos de API**  
Para reduzir o número de mapeamentos de API para um nome de domínio personalizado, use mapeamentos de API com um único nível, como `/prod`. Os mapeamentos de API com um único nível não entram na contagem da cota de mapeamentos de API.

**Autorizadores por API**  
Para reduzir o número de autorizadores por API, reutilize os autorizadores em todos os métodos da API.

**Partes da documentação por API**  
Para reduzir o número de partes da documentação por API, use `ignore=documentation` ao importar a API. Para obter mais informações, consulte [Importar a documentação da API](api-gateway-documenting-api-quick-start-import-export.md).  
Você também pode usar a herança de conteúdo para permitir que algumas partes da documentação herdem conteúdo de uma entidade de API com uma especificação mais geral. Para obter mais informações, consulte [Representação da documentação da API no API Gateway](api-gateway-documenting-api-content-representation.md).

**Quantidade de caracteres da política de recursos do API Gateway**  
Para reduzir o tamanho de uma política de recursos, use o AWS WAFV2 para proteger a API. Para obter mais informações, consulte [Usar o AWS WAF para proteger as APIs REST no API Gateway](apigateway-control-access-aws-waf.md).  
Se a política contiver endereços IP, você também pode usar intervalos em vez de valores específicos para definir endereços IP.

**Planos de uso por chave de API**  
Para reduzir o número de planos de uso por chave de API, use uma chave de API por plano de uso e associe o plano de uso a várias APIs. Não recomendamos compartilhar uma chave de API em vários planos de uso.