# Cuotas de Amazon API Gateway
Las siguientes cuotas se aplican a todos los tipos de API de Amazon API Gateway.
## Cuotas de nivel de cuenta de API Gateway, por región
Las siguientes cuotas se aplican por cuenta, por región en Amazon API Gateway.
| Recurso u operación | Cuota predeterminada | Se puede aumentar |
| --- | --- | --- |
| Cuota de limitación controlada por cuenta y región para todas las API REST, las API de WebSocket y las API de devolución de llamada de WebSocket | 10 000 solicitudes por segundo (RPS) con una capacidad de ráfaga adicional proporcionada por el [algoritmo de bucket de tokens](https://en.wikipedia.org/wiki/Token_bucket), utilizando una capacidad máxima de bucket de 5,000 solicitudes. \$1 La cuota de ráfaga la determina el equipo del servicio de API Gateway en función de las cuotas de RPS globales de la cuenta en la región. No es una cuota que los clientes puedan controlar o para el que puedan solicitar cambios. | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-8A5B8E43) |
| Límite de la cuota sin control de acceso por cuenta y región para un portal | 250,000 solicitudes por segundo | No |
| Límite de la cuota con control de acceso por cuenta y región para un portal | 10,000 solicitudes por segundo | No |
\$1Para las siguientes regiones, la cuota de limitación predeterminada es de 2500 RPS y la cuota de ráfaga predeterminada es de 1250 RPS: África (Ciudad del Cabo), Europa (Milán), Asia-Pacífico (Yakarta), Medio Oriente (EAU), Asia-Pacífico (Hyderabad), Asia-Pacífico (Melbourne), Europa (España), Europa (Zúrich), Israel (Tel Aviv), Oeste de Canadá (Calgary) y Asia-Pacífico (Malasia), Asia-Pacífico (Tailandia) y México (centro).
## Cuotas de API Gateway para crear, implementar y administrar una API
Las siguientes cuotas fijas se aplican a la creación, la implementación y la administración de una API en API Gateway, mediante la AWS CLI, la consola de API Gateway o la API REST de API Gateway y sus SDK. Estas cuotas no se pueden aumentar.
| Acción | Cuota predeterminada | Se puede aumentar |
| --- | --- | --- |
| [CreateApiKey](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateApiKey.html) | Cinco solicitudes por segundo y por cuenta | No |
| [CreateDeployment](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateDeployment.html) | Una solicitud cada cinco segundos por cuenta | No |
| [CreateDocumentationVersion](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateDocumentationVersion.html) | Una solicitud cada 20 segundos por cuenta | No |
| [CreateDomainName](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateDomainName.html) | Una solicitud cada 30 segundos por cuenta | No |
| [CreateResource](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateResource.html) | Cinco solicitudes por segundo y por cuenta | No |
| [CreateRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateRestApi.html) para API regional o privada | Una solicitud cada tres segundos por cuenta | No |
| [CreateRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateRestApi.html) para API optimizada para el borde | Una solicitud cada 30 segundos por cuenta | No |
| [CreateVpcLink](https://docs.aws.amazon.com/apigatewayv2/latest/api-reference/vpclinks.html#CreateVpcLink) (V2) | 1 solicitud cada 15 segundos por cuenta | No |
| [DeleteApiKey](https://docs.aws.amazon.com/apigateway/latest/api/API_DeleteApiKey.html) | Cinco solicitudes por segundo y por cuenta | No |
| [DeleteDomainName](https://docs.aws.amazon.com/apigateway/latest/api/API_DeleteDomainName.html) | Una solicitud cada 30 segundos por cuenta | No |
| [DeleteResource](https://docs.aws.amazon.com/apigateway/latest/api/API_DeleteResource.html) | Cinco solicitudes por segundo y por cuenta | No |
| [DeleteRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_DeleteRestApi.html) | Una solicitud cada 30 segundos por cuenta | No |
| [GetResources](https://docs.aws.amazon.com/apigateway/latest/api/API_GetResources.html) | Cinco solicitudes cada dos segundos por cuenta | No |
| [DeleteVpcLink](https://docs.aws.amazon.com/apigatewayv2/latest/api-reference/vpclinks.html#DeleteVpcLink) (V2) | Una solicitud cada 30 segundos por cuenta | No |
| [ImportDocumentationParts](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportDocumentationParts.html) | Una solicitud cada 30 segundos por cuenta | No |
| [ImportRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportRestApi.html) para API regional o privada | Una solicitud cada tres segundos por cuenta | No |
| [ImportRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportRestApi.html) para API optimizada para el borde | Una solicitud cada 30 segundos por cuenta | No |
| [PutRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_PutRestApi.html) | Una solicitud por segundo por cuenta | No |
| [UpdateAccount](https://docs.aws.amazon.com/apigateway/latest/api/API_UpdateAccount.html) | Una solicitud cada 20 segundos por cuenta | No |
| [UpdateDomainName](https://docs.aws.amazon.com/apigateway/latest/api/API_UpdateDomainName.html) | Una solicitud cada 30 segundos por cuenta | No |
| [UpdateUsagePlan](https://docs.aws.amazon.com/apigateway/latest/api/API_UpdateUsagePlan.html) | Una solicitud cada 20 segundos por cuenta | No |
| Creación de un portal | Una solicitud cada tres segundos | No |
| Portal de actualizaciones | Dos solicitudes por minuto | No |
| Obtención de portal | 10 solicitudes por segundo | No |
| Lista de portales | 10 solicitudes por segundo | No |
| Portal de publicaciones | Dos solicitudes por minuto | No |
| DeletePortal | Dos solicitudes por minuto | No |
| PreviewPortal | Una solicitud cada tres segundos | No |
| DisablePortal | Dos solicitudes por minuto | No |
| GetPortalProduct | 10 solicitudes por segundo | No |
| ListPortalProduct | 5 solicitudes por segundo | No |
| CreatePortalProduct | 2 solicitudes por segundo | No |
| UpdatePortalProduct | 0.5 solicitudes por segundo | No |
| DeletePortalProduct | Una solicitud por segundo | No |
| PutPortalProductSharingPolicy | Una solicitud cada tres segundos | No |
| GetPortalProductSharingPolicy | 10 solicitudes por segundo | No |
| DeletePortalProductSharingPolicy | Una solicitud cada tres segundos | No |
| CreateProductRestEndpointPage | Una solicitud cada tres segundos | No |
| GetProductRestEndpointPage | 10 solicitudes por segundo | No |
| UpdateProductRestEndpointPage | Una solicitud cada tres segundos | No |
| DeleteProductRestEndpointPage | Una solicitud cada tres segundos | No |
| ListProductRestEndpointPages | 10 solicitudes por segundo | No |
| CreateProductPage | Una solicitud cada tres segundos | No |
| GetProductPage | 10 solicitudes por segundo | No |
| UpdateProductPage | Una solicitud cada tres segundos | No |
| DeleteProductPage | Una solicitud cada tres segundos | No |
| ListProductPages | 10 solicitudes por segundo | No |
| Otras operaciones | No hay cuota hasta la cuota total de la cuenta. | No |
| Total de operaciones | 10 solicitudes por segundo con una cuota de ráfaga de 40 solicitudes por segundo. | No |
# Cuotas para configurar y ejecutar una API de REST en API Gateway
Las siguientes cuotas se aplican a la configuración y la ejecución de una API REST en Amazon API Gateway. Si la cuota es por API, solo se puede aumentar en API específicas, no en todas las API de una cuenta.
Para obtener información sobre las cuotas en el nivel de cuenta, consulte [Cuotas de Amazon API Gateway](limits.md).
| Recurso u operación | Cuota predeterminada | Se puede aumentar |
| --- | --- | --- |
| Nombres de dominio personalizados públicos por cuenta y región | 120 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-A93447B8) |
| Nombres de dominio personalizados privados por cuenta y región | 50 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-24E7E662) |
| API regionales por región | 600 | No |
| API optimizadas para bordes por región | 120 | No |
| API privadas por cuenta por región | 600 | No |
| Asociaciones de acceso a nombres de dominio por cuenta | 100 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-4D98A8A5) |
| Mapeos de la API de varios niveles por dominio | 200 | No |
| Reglas de enrutamiento por dominio | 50 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-68B79FF0) |
| Longitud, en caracteres, de la URL para una API optimizada para límites | 8192 | No |
| Longitud, en caracteres, de la URL para una API regional | 10240 | No |
| Longitud, en caracteres, de la URL para una API privada | 8192 | No |
| Longitud, en caracteres, de la política de recursos de API Gateway | 8192 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-8B81B02C) |
| Claves de API por cuenta y por región | 10000 | No |
| Certificados de cliente por cuenta y por región | 60 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-824C9E42) |
| Autorizadores por API (AWS Lambda y Amazon Cognito) | 10 | Sí Para aumentar esta cuota, póngase en contacto con [AWS Support Center](https://console.aws.amazon.com/support/home#/) |
| Partes de documentación por API | 2000 | Sí Para aumentar esta cuota, póngase en contacto con [AWS Support Center](https://console.aws.amazon.com/support/home#/) |
| Recursos por API | 300 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-01C8A9E0) |
| Etapas por API | 10 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-379E48B0) |
| Variables de etapa por etapa | 100 | No |
| Longitud, en caracteres, de la clave en una variable de etapa | 64 | No |
| Longitud, en caracteres, del valor en una variable de etapa | 512 | No |
| Planes de uso por cuenta y por región | 300 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E8693075) |
| Planes de uso por clave de API | 10 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-985EB478) |
| Enlaces de VPC por cuenta y por región | 20 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-A4C7274F) |
| TTL de almacenamiento en caché de la API | 300 segundos de forma predeterminada y configurable entre 0 y 3600 por el propietario de la API. | No para el límite superior (3600) |
| Tamaño de respuesta en caché | 1048576 bytes. El cifrado de datos de la caché puede aumentar el tamaño del elemento que se almacena en la caché. | No |
| Tiempo de espera de integración para las API regionales | 50 milisegundos - 29 segundos para todos los tipos de integraciones, incluidas las integraciones de Lambda, proxy de Lambda, HTTP, proxy de HTTP y AWS. | [Sí \$1](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E5AE38E3) |
| Tiempo de espera de integración para API optimizadas para periferia | 50 milisegundos - 29 segundos para todos los tipos de integraciones, incluidas las integraciones de Lambda, proxy de Lambda, HTTP, proxy de HTTP y AWS. | No |
| Tiempo de espera de integración para API privadas | 50 milisegundos - 29 segundos para todos los tipos de integraciones, incluidas las integraciones de Lambda, proxy de Lambda, HTTP, proxy de HTTP y AWS. | [Sí \$1](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E5AE38E3) |
| Tamaño total combinado de todos los valores del encabezado, incluidos los nombres de los encabezados, los valores, los terminadores de línea y los espacios en blanco | 10240 bytes | No |
| Tamaño total combinado de todos los valores del encabezado para una API privada | 8000 bytes | No |
| Tamaño de carga | 10 MB | No |
| Etiquetas por etapa | 50 | No |
| Número de iteraciones en un bucle \$1foreach ... \$1end en las plantillas de asignación | 1 000 | No |
| Tamaño máximo de plantilla de asignación | 300 KB | No |
| Tamaño de la plantilla de registro de acceso | 3 KB | No |
| Longitud del ARN del método | 1600 bytes. Si el método contiene un parámetro de ruta y un cliente usa un valor que supera la longitud del ARN, la API devolverá una respuesta 414 Request URI too long. | No |
| Configuración de la limitación controlada a nivel del método para una etapa de un plan de uso | 20 | Sí Para aumentar esta cuota, póngase en contacto con [AWS Support Center](https://console.aws.amazon.com/support/home#/) |
| Tamaño de modelo por API | 400 KB | No |
| Número de certificados en un almacén de confianza | 1000 certificados con un tamaño de objeto total de hasta 1 MB. | No |
| Tiempo de inactividad de conexión | 310 segundos | No |
| Tamaño máximo del archivo de la definición de la API cuando se usa [restapi:import](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportRestApi.html) o [restapi:put](https://docs.aws.amazon.com/apigateway/latest/api/API_PutRestApi.html) | 6 MB | No |
\$1No puede establecer el tiempo de espera de la integración en menos de 50 milisegundos. Puede aumentar el tiempo de espera de integración a más de 29 segundos, pero esto podría requerir una reducción de la cuota de limitación de nivel regional de la cuenta.
## Prácticas recomendadas para reducir las cuotas
Las siguientes prácticas recomendadas pueden ayudar a reducir la cantidad actual de recursos para evitar aumentar la cuota. Asegúrese de que estas sugerencias funcionen para la arquitectura de la API.
**API por región**
Para reducir el número de API por región, exporte las API no utilizadas y, a continuación, elimínelas de API Gateway. Para obtener más información, consulte [Exportación de una API REST desde API Gateway](api-gateway-export-api.md).
**Etapas por API**
Para reducir el número de etapas por API, divida la API en varias API.
**Recursos por API**
Use rutas de `{proxy+}` para reducir la cantidad de recursos. Para obtener más información, consulte [Configuración de una integración de proxy con un recurso de proxy](api-gateway-set-up-simple-proxy.md).
**Asignación de API**
Para reducir la cantidad de asignaciones de API para un nombre de dominio personalizado, utilice asignaciones de API con niveles únicos, como `/prod`. Las asignaciones de la API con un solo nivel no cuentan para la cuota de asignaciones de la API.
**Autorizadores por cada API**
Para reducir el número de autorizadores por API, reutilícelos en todos los métodos de la API.
**Partes de documentación por API**
Para reducir el número de partes de documentación por API, utilice `ignore=documentation` al importar la API. Para obtener más información, consulte [Importar la documentación de API](api-gateway-documenting-api-quick-start-import-export.md).
También puede usar la herencia de contenido para permitir que algunas partes de la documentación hereden contenido de una entidad de API de una especificación más general. Para obtener más información, consulte [Representación de la documentación de la API en API Gateway](api-gateway-documenting-api-content-representation.md).
**Longitud, en caracteres, de la política de recursos de API Gateway**
Para reducir la longitud de una política de recursos, use AWS WAFV2 para proteger la API. Para obtener más información, consulte [Uso de AWS WAF para proteger sus API de REST en API Gateway](apigateway-control-access-aws-waf.md).
Si la política contiene direcciones IP, también puede usar rangos en lugar de valores específicos para definir las direcciones IP.
**Planes de uso por clave de API**
Para reducir el número de planes de uso por clave de la API, utilice una clave de la API por plan de uso y asocie el plan de uso a varias API. No recomendamos compartir una clave de API entre varios planes de uso.
# Cuotas para configurar y ejecutar una API HTTP en API Gateway
Las cuotas siguientes se aplican a la configuración y ejecución de una API HTTP en Amazon API Gateway. Si la cuota es por API, solo se puede aumentar en API específicas, no en todas las API de una cuenta. Para obtener información sobre las cuotas en el nivel de cuenta, consulte [Cuotas de Amazon API Gateway](limits.md)
| Recurso u operación | Cuota predeterminada | Se puede aumentar |
| --- | --- | --- |
| Rutas por API | 300 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-01C8A9E0) |
| Integraciones por API | 300 | No |
| Tiempo de espera de integración máximo | 30 segundos | No |
| Etapas por API | 10 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-379E48B0) |
| Mapeos de la API de varios niveles por dominio | 200 asignaciones de la API. Este límite no incluye la asignación de la API con niveles únicos, como /prod. | No |
| Etiquetas por etapa | 50 | No |
| Tamaño total combinado de la línea de la solicitud y los valores del encabezado | 10 240 bytes | No |
| Tamaño de carga | 10 MB | No |
| Dominios personalizados por cuenta y región | 120 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-A93447B8) |
| Tamaño de la plantilla de registro de acceso | 3 KB | No |
| Entrada de registro de Amazon CloudWatch Logs | 1 MB | No |
| Autorizadores por cada API | 10 | Sí Para aumentar esta cuota, póngase en contacto con [AWS Support Center](https://console.aws.amazon.com/support/home#/) |
| Destinatarios por autorizador | 50 | No |
| Ámbitos por ruta | 10 | No |
| Tiempo de espera para el punto de conexión de JSON Web Key Set | 1500 ms | No |
| Tamaño de respuesta desde el punto de conexión de JSON Web Key Set | 150 000 bytes | No |
| Tiempo de espera para el punto de conexión de detección de OpenID Connect | 1500 ms | No |
| Se agotó el tiempo de respuesta del autorizador de Lambda | 10 000 ms | No |
| Enlaces de VPC por cuenta y por región | 10 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-608BDCD4) |
| Subredes por enlace de VPC | 10 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-668C9B28) |
| Variables de etapa por etapa | 100 | No |
| Longitud, en caracteres, de la clave en una variable de etapa | 64 | No |
| Longitud, en caracteres, del valor en una variable de etapa | 512 | No |
## Prácticas recomendadas para reducir las cuotas
Las siguientes prácticas recomendadas pueden ayudar a reducir la cantidad actual de recursos para evitar aumentar la cuota. Asegúrese de que estas sugerencias funcionen para la arquitectura de la API.
**API por región**
Para reducir el número de API por región, exporte las API no utilizadas y, a continuación, elimínelas de API Gateway. Para obtener más información, consulte [Exportación de API HTTP desde API Gateway](http-api-export.md).
**Etapas por API**
Para reducir el número de etapas por API, divida su API en varias API.
**Autorizadores por cada API**
Para reducir el número de autorizadores por API, reutilice los autorizadores en todos los métodos de la API.
# Cuotas para configurar portales en API Gateway
Las siguientes cuotas se aplican a la creación de portales en API Gateway. Para obtener más información, consulte [Portales de API Gateway](apigateway-portals.md).
| Recurso u operación | Cuota predeterminada | Se puede aumentar |
| --- | --- | --- |
| Portales por cuenta | 15 | Sí |
| Productos de portal por portal | 200 | Sí |
| Productos de portal por cuenta | 2000 | Sí |
| Páginas de punto de conexión REST de producto por producto de portal | 40 | Sí |
| Páginas de producto por producto de portal | 40 | Sí |
| Tamaño de carga | 200 KB | No |
| Tamaño de la página de documentación por página de punto de conexión REST del producto | 32,000 caracteres | No |
| Tamaño de página personalizado para las páginas de productos | 32,000 caracteres | No |
| Nombres de dominio personalizados por portal | 1 | No |
| Autorizadores por portal | 1 | No |
# Cuotas para configurar y ejecutar WebSocket en API Gateway
Las siguientes cuotas se aplican a la configuración y la ejecución de una API de WebSocket en Amazon API Gateway. Si la cuota es por API, solo se puede aumentar en API específicas, no en todas las API de una cuenta. Para obtener información sobre las cuotas en el nivel de cuenta, consulte [Cuotas de Amazon API Gateway](limits.md)
| Recurso u operación | Cuota predeterminada | Se puede aumentar |
| --- | --- | --- |
| Conexiones nuevas por segundo por cuenta (en todas las API de WebSocket) por región | 500 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-9ED1E49A) |
| Conexiones simultáneas | No aplicable \$1 | No aplicable |
| AWS LambdaAutorizadores de por cada API | 10 | Sí Para aumentar esta cuota, póngase en contacto con [AWS Support Center](https://console.aws.amazon.com/support/home#/) |
| AWS LambdaTamaño de resultado de autorizador de | 8 KB | No |
| Rutas por API | 300 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-01C8A9E0) |
| Integraciones por API | 300 | Sí Para aumentar esta cuota, póngase en contacto con [AWS Support Center](https://console.aws.amazon.com/support/home#/) |
| Tiempo de espera de integración | 50 milisegundos - 29 segundos para todos los tipos de integraciones, incluidas las integraciones de Lambda, proxy de Lambda, HTTP, proxy de HTTP y AWS. | No |
| Etapas por API | 10 | [Sí](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-379E48B0) |
| Tamaño de trama de WebSocket | 32 KB | No |
| Tamaño de carga de mensajes | 128 KB \$1\$1 | No |
| Tamaño máximo de plantilla de asignación | 300 KB | No |
| Duración de la conexión para la API de WebSocket | 2 horas | No |
| Tiempo de inactividad de conexión | 10 minutos | No |
| Longitud, en caracteres, de la URL para una API de WebSocket | 4096 | No |
| Tamaño de la plantilla de registro de acceso | 3 KB | No |
\$1 API Gateway no impone un límite en las conexiones simultáneas. El número máximo de conexiones simultáneas está determinado por la tasa de conexiones nuevas por segundo y la duración máxima de la conexión de dos horas. Por ejemplo, con el límite predeterminado de 500 conexiones nuevas por segundo, si los clientes se conectan a la velocidad máxima durante dos horas, API Gateway puede servir hasta 3 600 000 conexiones simultáneas.
\$1\$1 Debido al límite del tamaño de la trama de WebSocket de 32 KB, los mensajes que superen este límite se deben dividir en varias tramas, cada una con un tamaño máximo de 32 KB. Esto se aplica a los comandos `@connections`. Si se recibe un mensaje (o una trama) de mayor tamaño, la conexión se cierra con el código 1009.
# Notas importantes de Amazon API Gateway
En la siguiente sección se ofrece más información que podría afectar al uso de API Gateway.
**Topics**
+ [Notas importantes de Amazon API Gateway para las API de HTTP](#api-gateway-known-issues-http-apis)
+ [Notas importantes de Amazon API Gateway para las API HTTP y de WebSocket](#api-gateway-known-issues-http-and-websocket-apis)
+ [Notas importantes de Amazon API Gateway para las API REST y de WebSocket](#api-gateway-known-issues-rest-and-websocket-apis)
+ [Notas importantes de Amazon API Gateway para las API de WebSocket](#api-gateway-known-issues-websocket-apis)
+ [Notas importantes de Amazon API Gateway para las API REST](#api-gateway-known-issues-rest-apis)
## Notas importantes de Amazon API Gateway para las API de HTTP
+ Las API de HTTP traducen los encabezados `X-Forwarded-*` entrantes como un encabezado `Forwarded` estándar y anexan el host, el protocolo y la IP de salida.
+ API Gateway agrega el encabezado Content-type a la solicitud si no hay carga útil y Content-Length es 0.
## Notas importantes de Amazon API Gateway para las API HTTP y de WebSocket
+ Amazon API Gateway no admite oficialmente Signature Version 4A para las API HTTP y de WebSocket.
## Notas importantes de Amazon API Gateway para las API REST y de WebSocket
+ API Gateway no permite compartir un nombre de dominio personalizado en las API REST y de WebSocket.
+ Los nombres de etapas solo pueden contener caracteres alfanuméricos, guiones y caracteres de subrayado. La longitud máxima es de 128 caracteres.
+ Las rutas `/ping` y `/sping` están reservadas para la comprobación de estado del servicio. No se producirá el resultado previsto si se usan estos recursos en el nivel de raíz de la API.
+ API Gateway limita actualmente los eventos de registro a 1024 bytes. Los eventos de registros de más de 1024 bytes, como cuerpos de solicitud y respuesta, los truncará API Gateway antes de su envío a CloudWatch Logs.
+ En la actualidad, las métricas de CloudWatch limitan los nombres y los valores de las dimensiones a 255 caracteres XML válidos. (Para obtener más información, consulte la [guía del usuario de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)). Los valores de dimensión son una función de los nombres definidos por el usuario, incluido el nombre de API, el nombre de etiqueta (etapa) y el nombre de recurso. Cuando elija estos nombres, asegúrese de no superar los límites de las métricas de CloudWatch.
+ El tamaño máximo de una plantilla de asignación es de 300 KB.
## Notas importantes de Amazon API Gateway para las API de WebSocket
+ API Gateway admite cargas de mensajes de hasta 128 KB con un tamaño máximo de trama de 32 KB. Si un mensaje supera los 32 KB, se debe dividir en varias tramas, cada una con tamaño máximo de 32 KB. Si se recibe un mensaje más grande, la conexión se cierra con el código 1009.
## Notas importantes de Amazon API Gateway para las API REST
+ El carácter de barra vertical del texto sin formato (`|`) y el carácter de llave (`{` o `}`) no son compatibles con las cadenas de consulta URL y deben codificarse en formato URL.
+ El carácter de punto y coma (`;`) no se admite en las cadenas de consulta URL de la solicitud ni en los resultados de los datos que se van a dividir.
+ Las API de REST decodifican los parámetros de solicitud codificados con URL antes de pasarlos a las integraciones de backend. Para los parámetros de solicitud de UTF-8, las API de REST decodifican los parámetros y, a continuación, los pasan en formato Unicode a las integraciones de backend. Las API de REST codifican en URL el carácter de porcentaje (`%`) antes de pasarlo a las integraciones de backend.
+ Cuando se utiliza la consola de API Gateway para probar una API, es posible que aparezca la respuesta "errores de punto de conexión desconocido" si un certificado autofirmado se presenta en el backend, si falta el certificado intermedio en la cadena de certificados o si el backend genera cualquier otra excepción relacionada con un certificado que no se reconoce.
+ En el caso de la entidad [https://docs.aws.amazon.com/apigateway/latest/api/API_Resource.html](https://docs.aws.amazon.com/apigateway/latest/api/API_Resource.html) o [https://docs.aws.amazon.com/apigateway/latest/api/API_Method.html](https://docs.aws.amazon.com/apigateway/latest/api/API_Method.html) de la API con una integración privada, debe eliminar estas entidades después de eliminar cualquier referencia codificada de forma rígida de [https://docs.aws.amazon.com/apigateway/latest/api/API_VpcLink.html](https://docs.aws.amazon.com/apigateway/latest/api/API_VpcLink.html). De lo contrario, quedará una integración pendiente y aparecerá un error en el que se indicará que el enlace VPC sigue en uso aunque la entidad `Resource` o `Method` se haya eliminado. Este comportamiento no se aplica cuando la integración privada hace referencia a `VpcLink` a través de una variable de etapa.
+ Los siguientes backends no son compatibles con la autenticación de clientes SSL con API Gateway:
+ [NGINX](https://nginx.org/en/)
+ [Heroku](https://www.heroku.com/)
+ API Gateway admite la mayor parte de la [especificación de OpenAPI 2.0](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md) y la [especificación de OpenAPI 3.0](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.1.md), con las siguientes excepciones:
+ Los segmentos de ruta solo pueden contener caracteres alfanuméricos, guiones, guiones bajos, puntos, comas, dos puntos y llaves. Los parámetros de la ruta deben ser segmentos de ruta separados. Por ejemplo, "resource/\$1path\$1parameter\$1name\$1" es válido; "resource\$1path\$1parameter\$1name\$1" no lo es.
+ Los nombres de modelo pueden contener únicamente caracteres alfanuméricos.
+ Para los parámetros de entrada, solo se admiten los siguientes atributos: , , , y: `name`, `in`, `required`, `type`, `description`. Los demás atributos se ignoran.
+ El tipo `securitySchemes`, si se utiliza, debe ser `apiKey`. Sin embargo, OAuth 2 y la autenticación de HTTP Basic se admiten a través de [autorizadores de Lambda](apigateway-use-lambda-authorizer.md); la configuración OpenAPI se consigue a través de [extensiones de proveedor](api-gateway-swagger-extensions-authorizer.md).
+ El campo `deprecated` no es compatible y se descarta en API exportadas.
+ Los modelos de API Gateway se definen utilizando [esquemas JSON, borrador 4](https://datatracker.ietf.org/doc/html/draft-zyp-json-schema-04), en lugar de los esquemas JSON que utiliza OpenAPI.
+ El parámetro `discriminator` no se admite en ningún objeto de esquema.
+ La etiqueta `example` no se admite.
+ El campo `nullable` no se admite.
+ `exclusiveMinimum` no es compatible con API Gateway.
+ Las etiquetas `maxItems` y `minItems` no están incluidas en la [validación de solicitud sencilla](api-gateway-method-request-validation.md). Para solucionarlo, actualice el modelo después de la importación antes de efectuar la validación.
+ Para OpenAPI 3.0, no puede tener `oneOf`, `anyOf` o `allOf` que utilice `$ref` en una definición dentro del mismo esquema. Puede ingresar directamente el esquema o definir un recurso de modelo de API Gateway independiente. Para obtener más información, consulte [Creación de modelos más complejos](models-mappings-models.md#api-gateway-request-validation-model-more-complex).
+ `oneOf` no es compatible con la generación de OpenAPI 2.0 o SDK.
+ El campo `readOnly` no se admite.
+ `$ref` no puede utilizarse para hacer referencia a otros archivos.
+ Las definiciones de respuesta con el formato `"500": {"$ref": "#/responses/UnexpectedError"}` no se admiten en la raíz de documentos de OpenAPI. Para solucionar este problema, sustituya la referencia por el esquema insertado.
+ Los números de tipo `Int32` o `Int64` no se admiten. A continuación se muestra un ejemplo:
```
"elementId": {
"description": "Working Element Id",
"format": "int32",
"type": "number"
}
```
+ El tipo de formato de número decimal (`"format": "decimal"`) no se admite en una definición de esquema.
+ En las respuestas a métodos, la definición del esquema debe ser un tipo de objeto y no puede tener un tipo primitivo. Por ejemplo, `"schema": { "type": "string"}` no se admite. Sin embargo, puede solucionar este problema con el siguiente tipo de objeto:
```
"schema": {
"$ref": "#/definitions/StringResponse"
}
"definitions": {
"StringResponse": {
"type": "string"
}
}
```
+ API Gateway no utiliza seguridad de nivel raíz definida en la especificación OpenAPI. Por lo tanto hay que definir la seguridad en un nivel de funcionamiento para que se aplique de forma adecuada.
+ La `default` palabra clave no ese admite.
+ API Gateway establece las siguientes restricciones y limitaciones al administrar métodos con una integración de Lambda o una integración HTTP.
+ Al procesar los nombres de encabezado y los parámetros de consulta, se distingue entre mayúsculas y minúsculas.
+ En la siguiente tabla se enumeran los encabezados que se pueden haber abandonado, reasignado o modificado al enviarse al punto de conexión de integración o desde él. En esta tabla:
+ `Remapped` significa que el nombre del encabezado se ha cambiado de `` a `X-Amzn-Remapped-`.
`Remapped Overwritten` significa que el nombre del encabezado se cambia de `` a `X-Amzn-Remapped-` y se sobrescribe el valor.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/apigateway/latest/developerguide/api-gateway-known-issues.html)
\$1 El encabezado `Authorization` se elimina si contiene una firma [Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) o si se usa la autorización de `AWS_IAM`.
+ El SDK de Android de una API generado por API Gateway utiliza la clase `java.net.HttpURLConnection`. Esta clase producirá una excepción no administrada en dispositivos con Android 4.4 y versiones anteriores si la reasignación del encabezado `WWW-Authenticate` a `X-Amzn-Remapped-WWW-Authenticate` produce una respuesta 401.
+ A diferencia de los SDK de Java, Android e iOS de una API generados por API Gateway, el SDK de JavaScript de una API generado por API Gateway no admite reintentos de error de nivel 500.
+ La invocación de prueba de un método utiliza el tipo de contenido predeterminado de `application/json` y no tiene en cuenta las especificaciones de cualquier otro tipo de contenido.
+ Al enviar solicitudes a una API pasando el encabezado `X-HTTP-Method-Override`, API Gateway anula el método. Por lo tanto, con el fin de pasar el encabezado al backend, el encabezado tiene que añadirse a la solicitud de integración.
+ Cuando una solicitud contiene varios tipos de medios en su encabezado `Accept`, API Gateway solo respeta el primer tipo de medio `Accept`. En aquella situación en la que no pueda controlar el orden de los tipos de medios `Accept` y el tipo de medio del contenido binario no sea el primero de la lista, puede agregar el primer tipo de medio `Accept` en la lista `binaryMediaTypes` de la API; API Gateway devolverá su contenido como binario. Por ejemplo, para enviar un archivo JPEG utilizando un elemento `![]()
` en un navegador, el navegador puede enviar `Accept:image/webp,image/*,*/*;q=0.8` en una solicitud. Al añadir `image/webp` a la lista `binaryMediaTypes`, el punto de conexión recibirá el archivo JPEG como binario.
+ Actualmente, no se permite personalizar la respuesta predeterminada de la gateway en `413 REQUEST_TOO_LARGE`.
+ API Gateway incluye un encabezado `Content-Type` para todas las respuestas de integración. De forma predeterminada, el tipo de contenido es `application/json`.