Cotas para configurar e executar uma API REST no API Gateway
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.
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 |
Nomes de domínio personalizados privados por conta e por região | 50 | Sim |
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 |
Mapeamentos de API de vários níveis por domínio | 200 | Não |
Regras de roteamento por domínio | 50 | Sim |
Comprimento, em caracteres, do URL de uma API otimizada para fronteiras | 8192 | Não |
Comprimento, em caracteres, do URL de uma API regional | 10240 | Não |
Tamanho, em caracteres, da política de recursos do API Gateway | 8192 | Sim |
Chaves de API por conta por região | 10000 | Não |
Certificados de cliente por conta por região | 60 | Sim |
Autorizadores por API (AWS Lambda e Amazon Cognito) | 10 |
Sim Para aumentar essa cota, entre em contato com o AWS Support Center |
Partes da documentação por API | 2000 |
Sim Para aumentar essa cota, entre em contato com o AWS Support Center |
Recursos por API | 300 | Sim |
Estágios por API | 10 | Sim |
Variáveis de estágio por estágio | 100 | Não |
Comprimento, em caracteres, da chave em uma variável de estágio | 64 | Não |
Comprimento, em caracteres, do valor em uma variável de estágio | 512 | Não |
Planos de uso por conta por região | 300 | Sim |
Planos de uso por chave de API | 10 | Sim |
Links de VPC por conta por região | 20 | Sim |
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 * |
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 * |
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 #foreach ... #end em modelos de mapeamento |
1000 | Não |
Tamanho máximo do modelo de mapeamento | 300 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 |
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 ou restapi:put | 6 MB | Não |
* 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
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.
- 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. - 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.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.
- Tamanho, em 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.
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.