# Cotas do Amazon API Gateway
As cotas a seguir se aplicam a todos os tipos de API do Amazon API Gateway.
## 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](https://en.wikipedia.org/wiki/Token_bucket), usando uma capacidade máxima de bucket de 5.000 solicitações. \$1 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](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-8A5B8E43) |
| Cota de controle de utilização sem controle de acesso por conta por região para um portal | 250,000 solicitações por segundo | Não |
| Cota de controle de utilização com controle de acesso por conta por região para um portal | 10,000 solicitações por segundo | Não |
\$1 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), Ásia-Pacífico (Malásia), Ásia-Pacífico (Tailândia) e México (Centro).
## 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](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateApiKey.html) | 5 solicitações por segundo por conta | Não |
| [CreateDeployment](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateDeployment.html) | 1 solicitação a cada 5 segundos por conta | Não |
| [CreateDocumentationVersion](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateDocumentationVersion.html) | 1 solicitação a cada 20 segundos por conta | Não |
| [CreateDomainName](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateDomainName.html) | 1 solicitação a cada 30 segundos por conta | Não |
| [CreateResource](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateResource.html) | 5 solicitações por segundo por conta | Não |
| [CreateRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateRestApi.html) para API regional ou privada. | 1 solicitação a cada 3 segundos por conta | Não |
| [CreateRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateRestApi.html) para API otimizada para borda. | 1 solicitação a cada 30 segundos por conta | Não |
| [CreateVpcLink](https://docs.aws.amazon.com/apigatewayv2/latest/api-reference/vpclinks.html#CreateVpcLink) (V2) | 1 solicitação a cada 15 segundos por conta | Não |
| [DeleteApiKey](https://docs.aws.amazon.com/apigateway/latest/api/API_DeleteApiKey.html) | 5 solicitações por segundo por conta | Não |
| [DeleteDomainName](https://docs.aws.amazon.com/apigateway/latest/api/API_DeleteDomainName.html) | 1 solicitação a cada 30 segundos por conta | Não |
| [DeleteResource](https://docs.aws.amazon.com/apigateway/latest/api/API_DeleteResource.html) | 5 solicitações por segundo por conta | Não |
| [DeleteRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_DeleteRestApi.html) | 1 solicitação a cada 30 segundos por conta | Não |
| [GetResources](https://docs.aws.amazon.com/apigateway/latest/api/API_GetResources.html) | 5 solicitações a cada 2 segundos por conta | Não |
| [DeleteVpcLink](https://docs.aws.amazon.com/apigatewayv2/latest/api-reference/vpclinks.html#DeleteVpcLink) (V2) | 1 solicitação a cada 30 segundos por conta | Não |
| [ImportDocumentationParts](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportDocumentationParts.html) | 1 solicitação a cada 30 segundos por conta | Não |
| [ImportRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportRestApi.html) para API regional ou privada. | 1 solicitação a cada 3 segundos por conta | Não |
| [ImportRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportRestApi.html) para API otimizada para borda. | 1 solicitação a cada 30 segundos por conta | Não |
| [PutRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_PutRestApi.html) | 1 solicitação por segundo por conta | Não |
| [UpdateAccount](https://docs.aws.amazon.com/apigateway/latest/api/API_UpdateAccount.html) | 1 solicitação a cada 20 segundos por conta | Não |
| [UpdateDomainName](https://docs.aws.amazon.com/apigateway/latest/api/API_UpdateDomainName.html) | 1 solicitação a cada 30 segundos por conta | Não |
| [UpdateUsagePlan](https://docs.aws.amazon.com/apigateway/latest/api/API_UpdateUsagePlan.html) | 1 solicitação a cada 20 segundos por conta | Não |
| Criar portal | 1 pedido a cada 3 segundos | Não |
| Atualizar portal | 2 solicitações por minuto | Não |
| Receber portal | 10 solicitações por segundo | Não |
| Listar portais | 10 solicitações por segundo | Não |
| Publicar portal | 2 solicitações por minuto | Não |
| DeletePortal | 2 solicitações por minuto | Não |
| PreviewPortal | 1 pedido a cada 3 segundos | Não |
| DisablePortal | 2 solicitações por minuto | Não |
| GetPortalProduct | 10 solicitações por segundo | Não |
| ListPortalProduct | 5 solicitações por segundo | Não |
| CreatePortalProduct | 2 solicitações por segundo | Não |
| UpdatePortalProduct | 0.5 solicitações por segundo | Não |
| DeletePortalProduct | 1 pedido por segundo | Não |
| PutPortalProductSharingPolicy | 1 pedido a cada 3 segundos | Não |
| GetPortalProductSharingPolicy | 10 solicitações por segundo | Não |
| DeletePortalProductSharingPolicy | 1 pedido a cada 3 segundos | Não |
| CreateProductRestEndpointPage | 1 pedido a cada 3 segundos | Não |
| GetProductRestEndpointPage | 10 solicitações por segundo | Não |
| UpdateProductRestEndpointPage | 1 pedido a cada 3 segundos | Não |
| DeleteProductRestEndpointPage | 1 pedido a cada 3 segundos | Não |
| ListProductRestEndpointPages | 10 solicitações por segundo | Não |
| CreateProductPage | 1 pedido a cada 3 segundos | Não |
| GetProductPage | 10 solicitações por segundo | Não |
| UpdateProductPage | 1 pedido a cada 3 segundos | Não |
| DeleteProductPage | 1 pedido a cada 3 segundos | Não |
| ListProductPages | 10 solicitações por segundo | 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 |
# 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](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
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.
# Cotas para configurar e executar uma API HTTP no API Gateway
As cotas a seguir são aplicáveis à configuração e à execução de uma API HTTP 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 aumentado |
| --- | --- | --- |
| Rotas por API | 300 | [Sim](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-01C8A9E0) |
| Integrações por API | 300 | Não |
| Tempo limite máximo de integração | 30 segundos | Não |
| Estágios por API | 10 | [Sim](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-379E48B0) |
| Mapeamentos de API de vários níveis por domínio | Duzentos mapeamentos de API. Esse limite não inclui mapeamento de API com um único nível, como /prod. | 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](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-A93447B8) |
| 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 Para aumentar essa cota, entre em contato com o [AWS Support Center](https://console.aws.amazon.com/support/home#/). |
| 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](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-608BDCD4) |
| Sub-redes por link de VPC | 10 | [Sim](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-668C9B28) |
| 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 |
## 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 APIs HTTP do API Gateway](http-api-export.md).
**Estágios por API**
Para reduzir o número de estágios por API, divida a API em várias APIs.
**Autorizadores por API**
Para reduzir o número de autorizadores por API, reutilize os autorizadores em todos os métodos da API.
# Cotas para configuração de portais no API Gateway
As cotas a seguir se aplicam à criação de portais no API Gateway. Para obter mais informações, consulte [Portais do API Gateway](apigateway-portals.md).
| Recurso ou operação | Cota padrão | Pode ser aumentado |
| --- | --- | --- |
| Portais por conta | 15 | Sim |
| Produtos de portal por portal | 200 | Sim |
| Produtos de portal por conta | 2000 | Sim |
| Páginas de endpoint REST do produto por produto do portal | 40 | Sim |
| Páginas de produto por produto do portal | 40 | Sim |
| Tamanho do logo | 200 KB | Não |
| Tamanho da página de documentação por página de endpoint REST do produto | 32,000 caracteres | Não |
| Tamanho de página personalizado para páginas de produtos | 32,000 caracteres | Não |
| Nomes de domínio personalizados por portal | 1 | Não |
| Autorizadores por portal | 1 | Não |
# Cotas para configurar e executar um WebSocket no API Gateway.
As cotas a seguir se aplicam à configuração e à execução de uma API de WebSocket 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 aumentado |
| --- | --- | --- |
| Novas conexões por segundo e por conta (em todas as APIs WebSocket) por região | 500 | [Sim](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-9ED1E49A) |
| Conexões simultâneas | Não aplicável \$1 | Não aplicável |
| Autorizadores do AWS Lambda por API | 10 | Sim Para aumentar essa cota, entre em contato com o [AWS Support Center](https://console.aws.amazon.com/support/home#/). |
| Tamanho do resultado do autorizador do AWS Lambda | 8 KB | Não |
| Rotas por API | 300 | [Sim](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-01C8A9E0) |
| Integrações por API | 300 | Sim Para aumentar essa cota, entre em contato com o [AWS Support Center](https://console.aws.amazon.com/support/home#/). |
| 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](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-379E48B0) |
| Tamanho de quadros WebSocket | 32 KB | Não |
| Tamanho da carga da mensagem | 128 KB \$1\$1 | 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 |
| Tamanho do modelo de log de acesso | 3 KB | Não |
\$1 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.
\$1\$1 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.
# Notas importantes do Amazon API Gateway
A seção a seguir detalha as observações que podem afetar o uso do API Gateway.
**Topics**
+ [Observações importantes sobre o Amazon API Gateway para APIs HTTP](#api-gateway-known-issues-http-apis)
+ [Observações importantes do Amazon API Gateway para HTTP e APIs de WebSocket](#api-gateway-known-issues-http-and-websocket-apis)
+ [Notas importantes do Amazon API Gateway para APIs REST e WebSocket](#api-gateway-known-issues-rest-and-websocket-apis)
+ [Notas importantes do Amazon API Gateway para APIs WebSocket](#api-gateway-known-issues-websocket-apis)
+ [Notas importantes do Amazon API Gateway para APIs REST](#api-gateway-known-issues-rest-apis)
## Observações importantes sobre o Amazon API Gateway para APIs HTTP
+ As APIs HTTP convertem os cabeçalhos `X-Forwarded-*` de entrada em um cabeçalho `Forwarded` padrão e anexam o IP de saída, o host e o protocolo.
+ O API Gateway adicionará o cabeçalho Content-type à solicitação se não houver carga útil e o Content-Length for 0.
## Observações importantes do Amazon API Gateway para HTTP e APIs de WebSocket
+ O Signature Version 4a não é oficialmente compatível com o Amazon API Gateway para HTTP e APIs de WebSocket.
## Notas importantes do Amazon API Gateway para APIs REST e WebSocket
+ O API Gateway não é compatível com o compartilhamento de um nome de domínio personalizado em APIs REST e WebSocket.
+ Nomes de estágio podem conter apenas caracteres alfanuméricos, hífens e sublinhados. O tamanho máximo é de 128 caracteres.
+ Os caminhos `/ping` e `/sping` são reservados para a verificação de integridade do serviço. O uso desses recursos em nível raiz da API com domínios personalizados não conseguirá produzir o resultado esperado.
+ No momento, o API Gateway limita os eventos de log a 1.024 bytes. Eventos de log maiores do que 1024 bytes, como corpos de solicitação e resposta, serão truncados pelo API Gateway antes do envio para o CloudWatch Logs.
+ Atualmente, as métricas do CloudWatch limitam os nomes e valores de dimensão a 255 caracteres XML válidos. (Para obter mais informações, consulte o [Guia do usuário do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension).) Os valores de dimensão são uma função de nomes definidos pelo usuário, incluindo o nome da API, o nome do rótulo (estágio) e o nome do recurso. Ao escolher esses nomes, tenha cuidado para não exceder os limites de métricas do CloudWatch.
+ O tamanho máximo de um modelo de mapeamento é de 300 KB.
## Notas importantes do Amazon API Gateway para APIs WebSocket
+ O API Gateway é compatível com cargas de mensagem de até 128 KB com quadros no tamanho máximo de 32 KB. Se uma mensagem exceder 32 KB, é necessário dividi-la em vários quadros, cada qual contendo 32 KB ou menos. Se uma mensagem maior for recebida, a conexão será encerrada com o código 1009.
## Notas importantes do Amazon API Gateway para APIs REST
+ O caractere pipe de texto simples (`|`) e o caractere de chave (`{` ou `}`) não podem ser usados em nenhuma solicitação de string de consulta de URL e devem ser codificados em URL.
+ O caractere ponto-e-vírgula (`;`) não tem suporte para nenhuma string de consulta de URL da solicitação e resulta nos dados divididos.
+ As APIs REST decodificam parâmetros de solicitação codificados em URL antes de transmiti-los para integrações de back-end. Para parâmetros de solicitação UTF-8, as APIs REST decodificam os parâmetros, depois os transmitem como unicode para integrações de back-end. As APIs REST codificam em URL o caractere de porcentagem (`%`) antes de passá-lo para integrações de backend.
+ Ao usar o console do API Gateway para testar uma API, você pode obter a resposta “unknown endpoint errors” (erros de endpoint desconhecido) se um certificado autoassinado for apresentado ao backend, o certificado intermediário estiver ausente da cadeia de certificados ou qualquer outra exceção relacionada a certificados irreconhecíveis for lançada pelo backend.
+ Para uma entidade [https://docs.aws.amazon.com/apigateway/latest/api/API_Resource.html](https://docs.aws.amazon.com/apigateway/latest/api/API_Resource.html) ou [https://docs.aws.amazon.com/apigateway/latest/api/API_Method.html](https://docs.aws.amazon.com/apigateway/latest/api/API_Method.html) da API com integração privada, é necessário excluí-la depois de remover as referências codificadas permanentemente de um [https://docs.aws.amazon.com/apigateway/latest/api/API_VpcLink.html](https://docs.aws.amazon.com/apigateway/latest/api/API_VpcLink.html). Caso contrário, sua integração será suspensa e você receberá uma mensagem de erro informando que o link da VPC ainda está em uso, mesmo se a entidade `Resource` ou `Method` tiver sido excluída. Esse comportamento não se aplica quando a integração privada faz referência ao `VpcLink` por meio de uma variável de estágio.
+ Os backends a seguir podem não ser compatíveis com a autenticação de cliente SSL de uma forma que seja compatível com o API Gateway:
+ [NGINX](https://nginx.org/en/)
+ [Heroku](https://www.heroku.com/)
+ O API Gateway é compatível com a maior parte da [especificação do OpenAPI 2.0](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md) e da [especificação do OpenAPI 3.0](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.1.md), com as seguintes exceções:
+ Segmentos de caminho só podem conter caracteres alfanuméricos, sublinhados, hifens, pontos, vírgulas, dois-pontos e chaves. Parâmetros de caminho devem ser segmentos de caminho separados. Por exemplo, "resource/\$1path\$1parameter\$1name\$1" é válido; "resource\$1path\$1parameter\$1name\$1" não é.
+ Nomes de modelo podem conter apenas caracteres alfanuméricos.
+ Para parâmetros de entrada, somente os atributos a seguir são compatíveis: `name`, `in`, `required`, `type`, `description`. Outros atributos são ignorados.
+ Se usado, o tipo `securitySchemes` deverá ser `apiKey`. No entanto, OAuth 2 e autenticação básica HTTP são compatíveis por meio de [autorizadores do Lambda](apigateway-use-lambda-authorizer.md); a configuração do OpenAPI é obtida por meio de [extensões do fornecedor](api-gateway-swagger-extensions-authorizer.md).
+ O campo `deprecated` não tem suporte e é descartado em APIs exportadas.
+ Os modelos do API Gateway são definidos usando [esquema JSON rascunho 4](https://datatracker.ietf.org/doc/html/draft-zyp-json-schema-04) em vez do esquema JSON usado pelo OpenAPI.
+ O parâmetro `discriminator` não tem suporte em nenhum objeto de esquema.
+ Não há suporte para a tag `example`.
+ Não há suporte para o campo `nullable`.
+ `exclusiveMinimum` não é compatível com o API Gateway.
+ As marcas `maxItems` e `minItems` não estão incluídas na [validação de solicitação simples](api-gateway-method-request-validation.md). Para resolver esse problema, atualize o modelo após a importação, antes de fazer a validação.
+ Com relação à OpenAPI 3.0, não é possível ter um `oneOf`, `anyOf` ou `allOf` que use `$ref` para uma definição dentro do mesmo esquema. Você pode inserir diretamente o esquema ou definir um recurso de modelo distinto do API Gateway. Para obter mais informações, consulte [Criar modelos mais complexos](models-mappings-models.md#api-gateway-request-validation-model-more-complex).
+ `oneOf` não é compatível com OpenAPI 2.0 ou a geração de SDK.
+ Não há suporte para o campo `readOnly`.
+ `$ref` não pode ser usado para referenciar outros arquivos.
+ Definições de resposta do formulário `"500": {"$ref": "#/responses/UnexpectedError"}` não têm suporte na raiz do documento do OpenAPI. Para contornar esse problema, substitua a referência pelo esquema embutido.
+ Não há suporte para números do tipo `Int32` ou `Int64`. Um exemplo é mostrado conforme a seguir:
```
"elementId": {
"description": "Working Element Id",
"format": "int32",
"type": "number"
}
```
+ O tipo de formato de número decimal (`"format": "decimal"`) não tem suporte em uma definição de esquema.
+ Em respostas de método, a definição de esquema deve ser de um tipo de objeto e não pode ser de tipos primitivos. Por exemplo, não há suporte para `"schema": { "type": "string"}`. No entanto, você pode contornar esse problema usando o seguinte tipo de objeto:
```
"schema": {
"$ref": "#/definitions/StringResponse"
}
"definitions": {
"StringResponse": {
"type": "string"
}
}
```
+ O API Gateway não usa segurança no nível raiz definida na especificação do OpenAPI. Portanto, é necessário definir a segurança em um nível de operação a ser adequadamente aplicado.
+ A palavra-chave `default` não é compatível.
+ O API Gateway impõe as seguintes restrições e limitações ao lidar com métodos com a integração do Lambda ou a integração HTTP.
+ Os nomes de cabeçalho e parâmetros de consulta são processados em uma forma com distinção entre letras maiúsculas e minúsculas.
+ A tabela a seguir lista os cabeçalhos que podem ser descartados, remapeados ou modificados quando enviados ao seu endpoint de integração ou enviados de volta pelo seu endpoint de integração. Nesta tabela:
+ `Remapped` significa que o nome de cabeçalho é alterado de `` para `X-Amzn-Remapped-`.
`Remapped Overwritten` significa que o nome de cabeçalho é alterado de `` para `X-Amzn-Remapped-` e o valor é substituído.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/apigateway/latest/developerguide/api-gateway-known-issues.html)
\$1 O cabeçalho `Authorization` será descartado se contiver uma assinatura do [Signature versão 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) ou se a autorização `AWS_IAM` for usada.
+ O SDK do Android de uma API gerada pelo API Gateway usa a classe `java.net.HttpURLConnection`. Essa classe lançará uma exceção sem tratamento, em dispositivos executando o Android 4.4 e anteriores, para uma resposta 401 resultante do remapeamento do cabeçalho `WWW-Authenticate` para `X-Amzn-Remapped-WWW-Authenticate`.
+ Diferentemente dos SDKs Java, Android e iOS gerados pelo API Gateway de uma API, o SDK JavaScript de uma API gerada pelo API Gateway não é compatível com a novas tentativas para erros de nível 500.
+ A invocação de teste de um método usa o tipo de conteúdo padrão de `application/json` e ignora especificações de todos os outros tipos de conteúdo.
+ Ao enviar solicitações para uma API transmitindo o cabeçalho `X-HTTP-Method-Override`, o API Gateway substituirá o método. Portanto, para transmitir o cabeçalho ao backend, o cabeçalho precisa ser adicionado à solicitação de integração.
+ Quando uma solicitação contém vários tipos de mídia em seu cabeçalho `Accept`, o API Gateway apenas respeita o primeiro tipo de mídia `Accept`. Na situação em que você não pode controlar a ordem dos tipos de mídia de `Accept` e o tipo de mídia do seu conteúdo binário não é o primeiro da lista, é possível adicionar o primeiro tipo de mídia `Accept` na lista `binaryMediaTypes` da sua API, e o API Gateway retornará seu conteúdo como binário. Por exemplo, para enviar um arquivo JPEG usando um elemento `![]()
` em um navegador, o navegador pode enviar `Accept:image/webp,image/*,*/*;q=0.8` em uma solicitação. Ao adicionar `image/webp` à lista, o endpoint `binaryMediaTypes` receberá o arquivo JPEG como binário.
+ A personalização da resposta de gateway padrão para `413 REQUEST_TOO_LARGE` não é compatível no momento.
+ O API Gateway inclui um cabeçalho `Content-Type` para todas as respostas de integração. Por padrão, o tipo de conteúdo é `application/json`.