Cotas do Amazon API Gateway e notas importantes - Amazon API Gateway
Cotas no nível da conta do API Gateway, por regiãoCotas de API HTTPCotas do API Gateway para configurar e executar uma API de WebSocketCotas do API Gateway para configurar e executar uma API RESTCotas do API Gateway para criação, implantação e gerenciamento de uma API

Cotas do Amazon API Gateway e notas importantes

A seção a seguir explica as cotas do Amazon API Gateway. Salvo indicação em contrário, as cotas podem ser aumentadas mediante solicitação. Para solicitar um aumento de cota, é possível usar o Service Quotas ou entrar em contato com a Central de Suporte da AWS.

Quando a autorização está habilitada em um método, o comprimento máximo do ARN do método (por exemplo, arn:aws:execute-api:{region-id}:{account-id}:{api-id}/{stage-id}/{method}/{resource}/{path}) é de 1600 bytes. Os valores do parâmetro de caminho (cujo tamanho é determinado em tempo de execução) podem fazer com que o comprimento do ARN exceda o limite. Quando isso acontece, o cliente da API recebe uma resposta 414 Request URI too long.

nota

Isso limita o tamanho do URI quando as políticas de recurso são usadas. No caso de APIs privadas em que uma política de recurso é necessária, isso limita o tamanho do URI de todas as APIs privadas.

Tópicos

Cotas no nível da conta do API Gateway, por região

As cotas a seguir são aplicáveis por conta, por região no Amazon API Gateway.

Recurso ou operação Cota padrão Pode ser aumentado
Controlar a cota por conta, por região em APIS HTTP, APIs REST, APIs do WebSocket e APIs de retorno de chamada do WebSocket 10.000 solicitações por segundo (RPS) com uma capacidade de intermitência adicional fornecida pelo algoritmo de bucket de tokens, usando uma capacidade máxima de bucket de 5.000 solicitações. *
nota

A cota de intermitência é determinada pela equipe de serviço do API Gateway com base na cota de RPS geral da conta na região. Não é uma cota que o cliente possa controlar ou solicitar alterações.

 Sim
APIs regionais 600 Não
APIs otimizadas para bordas 120 Não

* Para as seguintes regiões, a cota de controle de utilização padrão é 2.500 RPS e a cota de expansão padrão é 1.250 RPS: África (Cidade do Cabo), Europa (Milão), Ásia-Pacífico (Jacarta), Oriente Médio (EAU), Ásia-Pacífico (Hyderabad), Ásia-Pacífico (Melbourne), Europa (Espanha), Europa (Zurique), Israel (Tel Aviv), Oeste do Canadá (Calgary) e Ásia-Pacífico (Malásia).

Cotas de API HTTP

As cotas a seguir são aplicáveis à configuração e à execução de uma API HTTP no API Gateway.

Recurso ou operação Cota padrão Pode ser aumentado
Rotas por API 300 Sim
Integrações por API 300 Não
Tempo limite máximo de integração 30 segundos Não
Estágios por API 10 Sim
Mapeamentos de API de vários níveis por domínio 200 Não
Tags por estágio 50 Não
Tamanho total combinado dos valores de linha e de cabeçalho da solicitação 10.240 bytes Não
Tamanho da carga útil 10 MB Não
Domínios personalizados por conta por região 120 Sim
Tamanho do modelo de log de acesso 3 KB Não
Entrada de log do Amazon CloudWatch Logs 1 MB Não
Autorizadores por API 10 Sim
Públicos-alvo por autorizador 50 Não
Escopos por rota 10 Não
Tempo limite para o endpoint do conjunto de chaves Web JSON 1500 ms Não
Tamanho da resposta do endpoint do conjunto de chaves Web JSON 150.000 bytes Não
Tempo limite para o endpoint de descoberta do OpenID Connect 1500 ms Não
Tempo limite para resposta do autorizador do Lambda 10.000 ms Não
Links de VPC por conta por região 10 Sim
Sub-redes por link de VPC 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

Cotas do API Gateway para configurar e executar uma API de WebSocket

As cotas a seguir se aplicam à configuração e à execução de uma API de WebSocket no Amazon API Gateway.

Recurso ou operação Cota padrão Pode ser aumentado
Novas conexões por segundo e por conta (em todas as APIs WebSocket) por região 500 Sim
Conexões simultâneas Não aplicável * Não aplicável
Autorizadores do AWS Lambda por API 10 Sim
Tamanho do resultado do autorizador do AWS Lambda 8 KB Não
Rotas por API 300 Sim
Integrações por API 300 Sim
Tempo limite de integração 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
Estágios por API 10 Sim
Tamanho de quadros WebSocket 32 KB Não
Tamanho da carga da mensagem 128 KB ** Não
Tamanho máximo do modelo de mapeamento 300 KB Não
Duração da conexão para API de WebSocket 2 horas Não
Tempo limite de inatividade 10 minutos Não
Comprimento, em caracteres, do URL de uma API do WebSocket 4096 Não

* O API Gateway não impõe uma cota em conexões simultâneas. O número máximo de conexões simultâneas é determinado pela taxa de novas conexões por segundo e duração máxima da conexão de duas horas. Por exemplo, com a cota padrão de 500 novas conexões por segundo, se os clientes se conectarem à taxa máxima em duas horas, o API Gateway pode atender até 3.600.000 conexões simultâneas.

** Devido à cota de tamanho de quadro do WebSocket de 32 KB, uma mensagem com mais de 32 KB deve ser dividida em vários quadros, cada um contendo 32 KB ou menos. Isso se aplica aos comandos @connections. Se uma mensagem maior (ou quadro de tamanho maior) for recebida, a conexão será encerrada com o código 1009.

Cotas do API Gateway para configurar e executar uma API REST

As cotas a seguir se aplicam à configuração e à execução de uma API REST no Amazon API Gateway. Para restapi:import ou restapi:put, o tamanho máximo do arquivo de definição da API é 6 MB.

Todas as cotas por API só podem ser aumentadas em APIs específicas.

Recurso ou operação Cota padrão Pode ser aumentado
Nomes de domínio personalizados por conta e por região 120 Sim
Mapeamentos de API de vários níveis por domínio 200 Não
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
APIs privadas por conta e por região 600 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
Partes da documentação por API 2000 Sim
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 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 de um método com autorização 1600 bytes 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
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

* 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 no caso de APIs regionais e APIs privadas, mas isso pode exigir uma redução no limite de cota de controle de utilização no nível de região da sua conta.

Cotas do API Gateway para criação, implantação e gerenciamento de uma API

As cotas fixas a seguir se aplicam à criação, à implantação e ao gerenciamento de uma API no API Gateway, via AWS CLI, console do API Gateway ou API REST do API Gateway e seus SDKs. Essas cotas não podem ser aumentadas.

Ação Cota padrão Pode ser aumentado
CreateApiKey 5 solicitações por segundo por conta Não
CreateDeployment 1 solicitação a cada 5 segundos por conta Não
CreateDocumentationVersion 1 solicitação a cada 20 segundos por conta Não
CreateDomainName 1 solicitação a cada 30 segundos por conta Não
CreateResource 5 solicitações por segundo por conta Não
CreateRestApi
API regional ou privada

  • 1 solicitação a cada 3 segundos por conta

API otimizada para bordas

  • 1 solicitação a cada 30 segundos por conta

 Não
CreateVpcLink (V2) 1 solicitação a cada 15 segundos por conta Não
DeleteApiKey 5 solicitações por segundo por conta Não
DeleteDomainName 1 solicitação a cada 30 segundos por conta Não
DeleteResource 5 solicitações por segundo por conta Não
DeleteRestApi 1 solicitação a cada 30 segundos por conta Não
GetResources 5 solicitações a cada 2 segundos por conta Não
DeleteVpcLink (V2) 1 solicitação a cada 30 segundos por conta Não
ImportDocumentationParts 1 solicitação a cada 30 segundos por conta Não
ImportRestApi
API regional ou privada

  • 1 solicitação a cada 3 segundos por conta

API otimizada para bordas

  • 1 solicitação a cada 30 segundos por conta

 Não
PutRestApi 1 solicitação por segundo por conta Não
UpdateAccount 1 solicitação a cada 20 segundos por conta Não
UpdateDomainName 1 solicitação a cada 30 segundos por conta Não
UpdateUsagePlan 1 solicitação a cada 20 segundos por conta Não
Outras operações Nenhuma cota até a cota total da conta. Não
Totais de operações 10 solicitações por segundo com uma cota de intermitência de 40 solicitações por segundo. Não