Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Quotas Amazon API Gateway
Les quotas suivants s’appliquent à tous les types d’API Amazon API Gateway.
## Quotas au niveau du compte API Gateway, par région
Les quotas suivants s’appliquent par compte et par région dans Amazon API Gateway.
| Ressource ou opération | Quota par défaut | Peut être augmenté |
| --- | --- | --- |
| Limiter le quota par compte, par région sur HTTP APIs APIs WebSocket APIs, REST et callback WebSocket APIs | 10 000 demandes par seconde (RPS) avec une capacité de transmission en mode rafale supplémentaire fournie par l’[algorithme de compartiment à jeton](https://en.wikipedia.org/wiki/Token_bucket), en utilisant une capacité de compartiment maximale de 5 000 demandes. \$1 Le quota en mode rafale est déterminé par l’équipe de service API Gateway en fonction de l’ensemble des quotas RPS pour le compte dans la région. Ce n’est pas un quota qu’un client peut contrôler ou pour lequel il peut demander des modifications. | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-8A5B8E43) |
| Quota de limitation sans contrôle d'accès par compte et par région pour un portail | 250 000 demandes par seconde | Non |
| Quota de limitation avec contrôle d'accès par compte et par région pour un portail | 10 000 demandes par seconde | Non |
\$1 Pour les régions suivantes, le quota de limitation par défaut est de 2 500 RPS et le quota en mode rafale par défaut de 1 250 RPS : Afrique (Le Cap), Europe (Milan), Asie-Pacifique (Jakarta), Moyen-Orient (EAU), Asie-Pacifique (Hyderabad), Asie-Pacifique (Melbourne), Europe (Espagne), Europe (Zurich), Israël (Tel Aviv), Canada-Ouest (Calgary), Asie-Pacifique (Malaisie), Asie-Pacifique (Thaïlande) et Mexique (Centre).
## Quotas API Gateway concernant la création, le déploiement et la gestion d’une API
Les quotas fixes suivants s'appliquent à la création, au déploiement et à la gestion d'une API dans API Gateway, à l' AWS CLI aide de la console API Gateway ou de l'API REST API Gateway et de ses API SDKs. Ces quotas ne peuvent pas être augmentés.
| Action | Quota par défaut | Peut être augmenté |
| --- | --- | --- |
| [CreateApiKey](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateApiKey.html) | 5 demandes toutes les secondes par compte | Non |
| [CreateDeployment](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateDeployment.html) | 1 demande toutes les 5 secondes par compte | Non |
| [CreateDocumentationVersion](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateDocumentationVersion.html) | 1 demande toutes les 20 secondes par compte | Non |
| [CreateDomainName](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateDomainName.html) | 1 requête toutes les 30 secondes par compte | Non |
| [CreateResource](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateResource.html) | 5 demandes toutes les secondes par compte | Non |
| [CreateRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateRestApi.html)pour une API régionale ou privée | 1 requête toutes les 3 secondes par compte | Non |
| [CreateRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateRestApi.html)pour une API optimisée pour les périphériques | 1 requête toutes les 30 secondes par compte | Non |
| [CreateVpcLink](https://docs.aws.amazon.com/apigatewayv2/latest/api-reference/vpclinks.html#CreateVpcLink)(V2) | 1 demande toutes les 15 secondes par compte | Non |
| [DeleteApiKey](https://docs.aws.amazon.com/apigateway/latest/api/API_DeleteApiKey.html) | 5 demandes toutes les secondes par compte | Non |
| [DeleteDomainName](https://docs.aws.amazon.com/apigateway/latest/api/API_DeleteDomainName.html) | 1 requête toutes les 30 secondes par compte | Non |
| [DeleteResource](https://docs.aws.amazon.com/apigateway/latest/api/API_DeleteResource.html) | 5 demandes toutes les secondes par compte | Non |
| [DeleteRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_DeleteRestApi.html) | 1 requête toutes les 30 secondes par compte | Non |
| [GetResources](https://docs.aws.amazon.com/apigateway/latest/api/API_GetResources.html) | 5 requêtes toutes les 2 secondes par compte | Non |
| [DeleteVpcLink](https://docs.aws.amazon.com/apigatewayv2/latest/api-reference/vpclinks.html#DeleteVpcLink)(V2) | 1 requête toutes les 30 secondes par compte | Non |
| [ImportDocumentationParts](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportDocumentationParts.html) | 1 requête toutes les 30 secondes par compte | Non |
| [ImportRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportRestApi.html)pour une API régionale ou privée | 1 requête toutes les 3 secondes par compte | Non |
| [ImportRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportRestApi.html)pour une API optimisée pour les périphériques | 1 requête toutes les 30 secondes par compte | Non |
| [PutRestApi](https://docs.aws.amazon.com/apigateway/latest/api/API_PutRestApi.html) | 1 requête toutes les secondes par compte | Non |
| [UpdateAccount](https://docs.aws.amazon.com/apigateway/latest/api/API_UpdateAccount.html) | 1 demande toutes les 20 secondes par compte | Non |
| [UpdateDomainName](https://docs.aws.amazon.com/apigateway/latest/api/API_UpdateDomainName.html) | 1 requête toutes les 30 secondes par compte | Non |
| [UpdateUsagePlan](https://docs.aws.amazon.com/apigateway/latest/api/API_UpdateUsagePlan.html) | 1 demande toutes les 20 secondes par compte | Non |
| Créer un portail | 1 demande toutes les 3 secondes | Non |
| Portail de mise à jour | 2 demandes par minute | Non |
| Obtenir le portail | 10 requêtes par seconde | Non |
| Portails de listes | 10 requêtes par seconde | Non |
| Portail de publication | 2 demandes par minute | Non |
| DeletePortal | 2 demandes par minute | Non |
| PreviewPortal | 1 demande toutes les 3 secondes | Non |
| DisablePortal | 2 demandes par minute | Non |
| GetPortalProduct | 10 requêtes par seconde | Non |
| ListPortalProduct | 5 demandes par seconde | Non |
| CreatePortalProduct | 2 demandes par seconde | Non |
| UpdatePortalProduct | 0,5 demande par seconde | Non |
| DeletePortalProduct | 1 demande par seconde | Non |
| PutPortalProductSharingPolicy | 1 demande toutes les 3 secondes | Non |
| GetPortalProductSharingPolicy | 10 requêtes par seconde | Non |
| DeletePortalProductSharingPolicy | 1 demande toutes les 3 secondes | Non |
| CreateProductRestEndpointPage | 1 demande toutes les 3 secondes | Non |
| GetProductRestEndpointPage | 10 requêtes par seconde | Non |
| UpdateProductRestEndpointPage | 1 demande toutes les 3 secondes | Non |
| DeleteProductRestEndpointPage | 1 demande toutes les 3 secondes | Non |
| ListProductRestEndpointPages | 10 requêtes par seconde | Non |
| CreateProductPage | 1 demande toutes les 3 secondes | Non |
| GetProductPage | 10 requêtes par seconde | Non |
| UpdateProductPage | 1 demande toutes les 3 secondes | Non |
| DeleteProductPage | 1 demande toutes les 3 secondes | Non |
| ListProductPages | 10 requêtes par seconde | Non |
| Autres opérations | Pas de quota jusqu’au quota total du compte. | Non |
| Nombre total d’opérations | 10 requêtes toutes les secondes avec un quota en mode rafale de 40 requêtes par seconde. | Non |
# Quotas pour la configuration et l’exécution d’une API REST dans API Gateway
Les quotas suivants s’appliquent à la configuration et à l’exécution d’une API REST dans Amazon API Gateway. Si le quota est défini par API, il ne peut être augmenté que pour des applications spécifiques APIs, et non pour toutes les API APIs d'un compte.
Pour plus d’informations sur les quotas au niveau du compte consultez [Quotas Amazon API Gateway](limits.md).
| Ressource ou opération | Quota par défaut | Peut être augmenté |
| --- | --- | --- |
| Noms de domaine personnalisés publics par compte et par région | 120 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-A93447B8) |
| Noms de domaine personnalisés privés par compte et par région | 50 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-24E7E662) |
| Régional APIs par région | 600 | Non |
| Optimisé pour les périphériques APIs par région | 120 | Non |
| Privé APIs par compte et par région | 600 | Non |
| Associations d’accès aux noms de domaine par compte | 100 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-4D98A8A5) |
| Mappages d'API à plusieurs niveaux par domaine | 200 | Non |
| Règles de routage par domaine | 50 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-68B79FF0) |
| Longueur, en caractères, de l'URL pour une API optimisée pour les périphériques | 8192 | Non |
| Longueur, en caractères, de l'URL d'une API régionale | 10240 | Non |
| Longueur, en caractères, de l'URL d'une API privée | 8192 | Non |
| Longueur, en caractères, de la politique de ressources API Gateway | 8192 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-8B81B02C) |
| Clés d’API par compte et par région | 10 000 | Non |
| Certificats de client par compte et par région | 60 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-824C9E42) |
| Autorisateurs par API (AWS Lambda et Amazon Cognito) | 10 | Oui Pour augmenter ce quota, contactez le [Centre de support AWS](https://console.aws.amazon.com/support/home#/) |
| Parties de la documentation par API | 2000 | Oui Pour augmenter ce quota, contactez le [Centre de support AWS](https://console.aws.amazon.com/support/home#/) |
| Ressources par API | 300 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-01C8A9E0) |
| Étapes par API | 10 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-379E48B0) |
| Variables d'étape par étape | 100 | Non |
| Longueur, en caractères, de la clé d'une variable d'étape | 64 | Non |
| Longueur, en caractères, de la valeur d'une variable d'étape | 512 | Non |
| Plans d’utilisation par compte et par région | 300 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E8693075) |
| Plans d’utilisation par clé d’API | 10 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-985EB478) |
| Liens VPC par compte et par région | 20 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-A4C7274F) |
| Durée de vie de mise en cache des API | 300 secondes par défaut et configurable entre 0 et 3 600 par un propriétaire d’API. | Pas la limite supérieure (3 600) |
| Taille de la réponse mise en cache | 1 048 576 octets. Le chiffrement des données de cache peut augmenter la taille de l’élément mis en cache. | Non |
| Délai d'intégration pour Regional APIs | 50 millisecondes - 29 secondes pour tous les types d'intégration, y compris Lambda, le proxy Lambda, le HTTP, le proxy HTTP et les intégrations. AWS | [Oui \$1](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E5AE38E3) |
| Délai d'intégration pour une optimisation en périphérie APIs | 50 millisecondes - 29 secondes pour tous les types d'intégration, y compris Lambda, le proxy Lambda, le HTTP, le proxy HTTP et les intégrations. AWS | Non |
| Délai d'intégration pour le mode privé APIs | 50 millisecondes - 29 secondes pour tous les types d'intégration, y compris Lambda, le proxy Lambda, le HTTP, le proxy HTTP et les intégrations. AWS | [Oui \$1](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-E5AE38E3) |
| Taille totale combinée de toutes les valeurs d’en-tête, y compris les noms d’en-tête, les valeurs, les terminaisons de ligne et les espaces blancs | 10 240 octets | Non |
| Taille combinée totale de toutes les valeurs d’en-tête pour une API privée | 8 000 octets | Non |
| Taille de la charge utile | 10 Mo | Non |
| Balises par étape | 50 | Non |
| Nombre d’itérations dans une boucle \$1foreach ... \$1end dans les modèles de mappage | 1 000 | Non |
| Taille maximale du modèle de mappage | 300 Ko | Non |
| Taille du modèle de journal d’accès | 3 KO | Non |
| Longueur de l’ARN de la méthode | 1 600 octets. Si votre méthode contient un paramètre de chemin et qu’un client utilise une valeur supérieure à la longueur de l’ARN, votre API renverra une réponse 414 Request URI too long. | Non |
| Paramètres de limitation au niveau de la méthode pour une étape dans un plan d’utilisation | 20 | Oui Pour augmenter ce quota, contactez le [Centre de support AWS](https://console.aws.amazon.com/support/home#/) |
| Taille de modèle par API | 400 Ko | Non |
| Nombre de certificats d’un magasin de confiance | 1 000 certificats jusqu’à une taille totale d’objet de 1 Mo. | Non |
| Délai d’expiration des connexions inactives | 310 secondes | Non |
| Taille maximale du fichier de définition de l’API lors de l’utilisation de [restapi:import](https://docs.aws.amazon.com/apigateway/latest/api/API_ImportRestApi.html) ou de [restapi:put](https://docs.aws.amazon.com/apigateway/latest/api/API_PutRestApi.html) | 6 Mo | Non |
\$1 Vous ne pouvez pas définir le délai d’attente de l’intégration à moins de 50 millisecondes. Vous pouvez l’augmenter à plus de 29 secondes, mais cette opération peut nécessiter une réduction du quota de limitation au niveau de la région pour votre compte.
## Bonnes pratiques pour réduire vos quotas
Les bonnes pratiques suivantes peuvent vous aider à réduire votre nombre actuel de ressources pour ne pas avoir à augmenter votre quota. Assurez-vous que ces suggestions fonctionnent pour l’architecture de votre API.
**APIs par région**
Pour réduire le nombre de APIs par région, exportez ceux qui ne sont pas utilisés, APIs puis supprimez-les d'API Gateway. Pour de plus amples informations, veuillez consulter [Exportation d’une API REST à partir d’API Gateway](api-gateway-export-api.md).
**Étapes par API**
Pour réduire le nombre d'étapes par API, divisez votre API en plusieurs étapes APIs.
**Ressources par API**
Utilisez les chemins `{proxy+}` pour réduire le nombre de ressources. Pour de plus amples informations, veuillez consulter [Configuration de l’intégration de proxy avec une ressource proxy](api-gateway-set-up-simple-proxy.md).
**Mappages d’API**
Pour réduire le nombre de mappages d’API pour un nom de domaine personnalisé, utilisez des mappages d’API à un niveau tels que `/prod`. Les mappages d’API à un niveau ne sont pas pris en compte dans le quota de mappages des API.
**Mécanismes d’autorisation par API**
Pour réduire le nombre de mécanismes d’autorisation par API, réutilisez les mécanismes d’autorisation pour toutes les méthodes d’API.
**Parties de la documentation par API**
Pour réduire le nombre de parties de la documentation par API, utilisez `ignore=documentation` lorsque vous importez votre API. Pour de plus amples informations, veuillez consulter [Importation de la documentation d’une API](api-gateway-documenting-api-quick-start-import-export.md).
Vous pouvez également utiliser l’héritage de contenu pour autoriser certaines parties de la documentation à hériter du contenu d’une entité API d’une spécification plus générale. Pour de plus amples informations, veuillez consulter [Représentation de la documentation de l’API dans API Gateway](api-gateway-documenting-api-content-representation.md).
**Longueur, en caractères, de la politique de ressources API Gateway**
Pour réduire la durée d'une politique de ressources, AWS WAFV2 utilisez-la pour protéger votre API. Pour de plus amples informations, veuillez consulter [AWS WAF À utiliser pour protéger votre REST APIs dans API Gateway](apigateway-control-access-aws-waf.md).
Si votre politique contient des adresses IP, vous pouvez également utiliser des plages plutôt que des valeurs spécifiques pour définir les adresses IP.
**Plans d’utilisation par clé d’API**
Pour réduire le nombre de plans d'utilisation par clé d'API, utilisez une clé d'API par plan d'utilisation et associez votre plan d'utilisation à plusieurs APIs. Nous vous déconseillons d’utiliser une même clé d’API pour plusieurs plans d’utilisation.
# Quotas pour la configuration et l’exécution d’une API HTTP dans API Gateway
Les quotas suivants s’appliquent à la configuration et à l’exécution d’une API HTTP dans Amazon API Gateway. Si le quota est défini par API, il ne peut être augmenté que pour des applications spécifiques APIs, et non pour toutes les API APIs d'un compte. Pour plus d’informations sur les quotas au niveau du compte, consultez [Quotas Amazon API Gateway](limits.md)
| Ressource ou opération | Quota par défaut | Peut être augmenté |
| --- | --- | --- |
| Routes par API | 300 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-65B5C802) |
| Intégrations par API | 300 | Non |
| Délai d’intégration maximal | 30 secondes | Non |
| Étapes par API | 10 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-379E48B0) |
| Mappages d'API à plusieurs niveaux par domaine | 200 mappages d’API. Cette limite n’inclut pas les mappages d’API à un niveau tels que /prod. | Non |
| Balises par étape | 50 | Non |
| Taille totale combinée des valeurs de ligne de demande et d’en-tête | 10 240 octets | Non |
| Taille de la charge utile | 10 Mo | Non |
| Domaines personnalisés par compte et par région | 120 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-A93447B8) |
| Taille du modèle de journal d’accès | 3 KO | Non |
| Entrée dans le CloudWatch journal Amazon Logs | 1 Mo | Non |
| Mécanismes d’autorisation par API | 10 | Oui Pour augmenter ce quota, contactez le [Centre de support AWS](https://console.aws.amazon.com/support/home#/) |
| Audiences par mécanisme d’autorisation | 50 | Non |
| Portées par route | 10 | Non |
| Délai d’expiration pour le point de terminaison JSON Web Key Set | 1500 ms | Non |
| Taille de la réponse du point de terminaison JSON Web Key Set | 150 000 octets | Non |
| Délai d’expiration du point de terminaison de découverte OpenID Connect | 1500 ms | Non |
| Délai d’expiration pour la réponse du mécanisme d’autorisation Lambda | 10 000 ms | Non |
| Liens VPC par compte et par région | 10 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-608BDCD4) |
| Lien Sous-réseaux par VPC | 10 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-668C9B28) |
| Variables d'étape par étape | 100 | Non |
| Longueur, en caractères, de la clé d'une variable d'étape | 64 | Non |
| Longueur, en caractères, de la valeur d'une variable d'étape | 512 | Non |
## Bonnes pratiques pour réduire vos quotas
Les bonnes pratiques suivantes peuvent vous aider à réduire votre nombre actuel de ressources pour ne pas avoir à augmenter votre quota. Assurez-vous que ces suggestions fonctionnent pour l’architecture de votre API.
**APIs par région**
Pour réduire le nombre de APIs par région, exportez les éléments non utilisés, APIs puis supprimez-les d'API Gateway. Pour de plus amples informations, veuillez consulter [Exporter le protocole HTTP APIs depuis API Gateway](http-api-export.md).
**Étapes par API**
Pour réduire le nombre d'étapes par API, divisez votre API en plusieurs étapes APIs.
**Mécanismes d’autorisation par API**
Pour réduire le nombre de mécanismes d’autorisation par API, réutilisez les mécanismes d’autorisation pour toutes les méthodes d’API.
# Quotas pour la configuration des portails dans API Gateway
Les quotas suivants s'appliquent à la création de portails dans API Gateway. Pour de plus amples informations, veuillez consulter [Portails API Gateway](apigateway-portals.md).
| Ressource ou opération | Quota par défaut | Peut être augmenté |
| --- | --- | --- |
| Portails par compte | 15 | Oui |
| Produits de portail par portail | 200 | Oui |
| Produits du portail par compte | 2000 | Oui |
| Pages de point de terminaison REST du produit par produit de portail | 40 | Oui |
| Pages de produits par produit du portail | 40 | Oui |
| Taille du logo | 200 Ko | Non |
| Taille de page de documentation par page de point de terminaison REST du produit | 32 000 caractères | Non |
| Taille de page personnalisée pour les pages de produits | 32 000 caractères | Non |
| Noms de domaine personnalisés par portail | 1 | Non |
| Autorisateurs par portail | 1 | Non |
# Quotas pour la configuration et l'exécution d'une passerelle WebSocket intégrée à l'API
Les quotas suivants s'appliquent à la configuration et à l'exécution d'une WebSocket API dans Amazon API Gateway. Si le quota est défini par API, il ne peut être augmenté que pour des applications spécifiques APIs, et non pour toutes les API APIs d'un compte. Pour plus d’informations sur les quotas au niveau du compte, consultez [Quotas Amazon API Gateway](limits.md)
| Ressource ou opération | Quota par défaut | Peut être augmenté |
| --- | --- | --- |
| Nouvelles connexions par seconde par compte (dans l'ensemble WebSocket APIs) par région | 500 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-9ED1E49A) |
| Connexions simultanées | Ne s’applique pas \$1 | Non applicable |
| AWS Lambda autorisateurs par API | 10 | Oui Pour augmenter ce quota, contactez le [Centre de support AWS](https://console.aws.amazon.com/support/home#/) |
| AWS Lambda taille du résultat de l'autorisateur | 8 Ko | Non |
| Routes par API | 300 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-01C8A9E0) |
| Intégrations par API | 300 | Oui Pour augmenter ce quota, contactez le [Centre de support AWS](https://console.aws.amazon.com/support/home#/) |
| Délai d'intégration | 50 millisecondes - 29 secondes pour tous les types d'intégration, y compris Lambda, le proxy Lambda, le HTTP, le proxy HTTP et les intégrations. AWS | Non |
| Étapes par API | 10 | [Oui](https://console.aws.amazon.com/servicequotas/home/services/apigateway/quotas/L-379E48B0) |
| WebSocket taille du cadre | 32 Ko | Non |
| Taille de la charge utile des messages | 128 Ko \$1\$1 | Non |
| Taille maximale du modèle de mappage | 300 Ko | Non |
| Durée de connexion pour WebSocket l'API | 2 heures | Non |
| Délai d’expiration de connexion inactive | 10 minutes | Non |
| Longueur, en caractères, de l'URL d'une WebSocket API | 4096 | Non |
| Taille du modèle de journal d’accès | 3 KO | Non |
\$1 API Gateway n’applique pas de quota sur les connexions simultanées. Le nombre maximal de connexions simultanées est déterminé par le taux de nouvelles connexions par seconde et une durée maximale de connexion de deux heures. Par exemple, avec un quota par défaut de 500 nouvelles connexions par seconde, si les clients se connectent au taux maximal sur deux heures, API Gateway peut servir jusqu’à 3 600 000 connexions simultanées.
\$1\$1 En raison du quota de WebSocket taille de trame de 32 Ko, un message supérieur à 32 Ko doit être divisé en plusieurs trames de 32 Ko ou moins chacune. Cela s’applique aux commandes `@connections`. Si un message plus grand (ou une taille de trame supérieure) est reçu, la connexion se ferme avec le code 1009.
# Remarques importantes concernant Amazon API Gateway
La section suivante détaille les remarques susceptibles d’avoir un impact sur votre façon d’utiliser API Gateway.
**Topics**
+ [Remarques importantes concernant Amazon API Gateway pour le protocole HTTP APIs](#api-gateway-known-issues-http-apis)
+ [Remarques importantes concernant Amazon API Gateway pour HTTP et WebSocket APIs](#api-gateway-known-issues-http-and-websocket-apis)
+ [Remarques importantes concernant Amazon API Gateway pour REST et WebSocket APIs](#api-gateway-known-issues-rest-and-websocket-apis)
+ [Remarques importantes relatives à Amazon API Gateway pour WebSocket APIs](#api-gateway-known-issues-websocket-apis)
+ [Remarques importantes relatives à Amazon API Gateway pour REST APIs](#api-gateway-known-issues-rest-apis)
## Remarques importantes concernant Amazon API Gateway pour le protocole HTTP APIs
+ Le protocole HTTP APIs traduit `X-Forwarded-*` les en-têtes entrants en `Forwarded` en-tête standard et ajoute l'adresse IP, l'hôte et le protocole de sortie.
+ API Gateway ajoute l’en-tête Content-type à votre demande s’il n’y a pas de données utiles et si Content-Length est égal à 0.
## Remarques importantes concernant Amazon API Gateway pour HTTP et WebSocket APIs
+ Signature Version 4A n'est pas officiellement prise en charge par Amazon API Gateway pour HTTP et WebSocket APIs.
## Remarques importantes concernant Amazon API Gateway pour REST et WebSocket APIs
+ API Gateway ne prend pas en charge le partage d'un nom de domaine personnalisé entre REST et WebSocket APIs.
+ Les noms d’étape peuvent contenir uniquement des caractères alphanumériques, des tirets et des traits de soulignement. La longueur maximale est de 128 caractères.
+ Les chemins d’accès `/ping` et `/sping` sont réservés à la vérification de l’état du service. L’utilisation de ces chemins pour les ressources racine de l’API avec des domaines personnalisés ne permet pas d’obtenir le résultat attendu.
+ API Gateway limite actuellement les évènements de journaux à 1 024 octets. Les événements de journal de plus de 1 024 octets, tels que les corps de demande et de réponse, seront tronqués par API Gateway avant d'être soumis à CloudWatch Logs.
+ CloudWatch Metrics limite actuellement les noms et les valeurs des dimensions à 255 caractères XML valides. (Pour plus d'informations, consultez le [Guide de l'utilisateur CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension).) Les valeurs de dimension sont une fonction des noms définis par l’utilisateur, y compris le nom de l’API, le nom de l’étiquette (étape) et le nom de la ressource. Lorsque vous choisissez ces noms, veillez à ne pas dépasser CloudWatch les limites des métriques.
+ La taille maximale d’un modèle de mappage est de 300 Ko.
## Remarques importantes relatives à Amazon API Gateway pour WebSocket APIs
+ API Gateway prend en charge des charges utiles de messages jusqu’à 128 Ko, avec une taille de trame maximale de 32 Ko. Si un message dépasse 32 Ko, vous devez le diviser en plusieurs trames, chacune de 32 Ko ou moins. Si un message plus grand est reçu, la connexion se ferme avec le code 1009.
## Remarques importantes relatives à Amazon API Gateway pour REST APIs
+ Le caractère pipe en texte brut (`|`) et l’accolade (`{` ou `}`) ne sont pas pris en charge pour les chaînes de requête des URL de demande et doit être encodé en URL.
+ Le caractère point-virgule (`;`) n’est pas pris en charge pour les chaînes de requête d’URL et entraîne le fractionnement des données.
+ REST APIs décode les paramètres de requête codés en URL avant de les transmettre aux intégrations du backend. Pour les paramètres de requête UTF-8, REST APIs décode les paramètres puis les transmet au format Unicode aux intégrations du backend. APIs Encodez en URL REST le caractère de pourcentage (`%`) avant de le transmettre aux intégrations du backend.
+ Lorsque vous utilisez la console API Gateway pour tester une API, vous pouvez recevoir une réponse de type « erreurs de point de terminaison inconnu » si un certificat auto-signé est présenté au backend, si le certificat intermédiaire est absent de la chaîne de certificats ou si toute autre exception liée à un certificat non reconnaissable est déclenchée par le backend.
+ Pour les entités d’API [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) avec une intégration privée, vous devez les supprimer après avoir supprimé toute référence codée en dur de [https://docs.aws.amazon.com/apigateway/latest/api/API_VpcLink.html](https://docs.aws.amazon.com/apigateway/latest/api/API_VpcLink.html). Dans le cas contraire, vous disposez d’une intégration instable et recevez une erreur indiquant que le lien du VPC est toujours actif même lorsque l’entité `Resource` ou `Method` est supprimée. Ce comportement ne s’applique pas lorsque l’intégration privée renvoie à `VpcLink` par le biais d’une variable d’étape.
+ Les backends suivants peuvent ne pas prendre en charge l’authentification de client SSL d’une manière compatible avec API Gateway :
+ [NGINX](https://nginx.org/en/)
+ [Heroku](https://www.heroku.com/)
+ API Gateway prend en charge la majeure partie de la [spécification OpenAPI 2.0](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md) et de la [spécification OpenAPI 3.0](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.1.md), avec les exceptions suivantes :
+ Les segments de chemin peuvent contenir uniquement des caractères alphanumériques, des tirets, des points, des virgules, des doubles points et des accolades. Les paramètres de chemin doivent être des segments de chemin distincts. Par exemple, « resource/\$1path\$1parameter\$1name\$1 » est valide ; « resource\$1path\$1parameter\$1name\$1 » ne l’est pas.
+ Les noms de modèle ne peuvent contenir que des caractères alphanumériques.
+ Pour les paramètres d’entrée, seuls les attributs suivants sont pris en charge: `name`, `in`, `required`, `type`, `description`. Les autres attributs sont ignorés.
+ S’il est utilisé, le type `securitySchemes` doit être `apiKey`. [Cependant, les authentifications OAuth 2 et HTTP Basic sont prises en charge via les [autorisateurs Lambda ;](apigateway-use-lambda-authorizer.md) la configuration OpenAPI est réalisée via les extensions des fournisseurs.](api-gateway-swagger-extensions-authorizer.md)
+ Le `deprecated` champ n'est pas pris en charge et est supprimé lors de l'exportation APIs.
+ Les modèles API Gateway sont définis à l’aide du [schéma JSON version 4](https://datatracker.ietf.org/doc/html/draft-zyp-json-schema-04), plutôt que de celui utilisé par OpenAPI.
+ Le paramètre `discriminator` n’est pris en charge dans aucun objet de schéma.
+ La balise `example` n’est pas prise en charge.
+ Le champ `nullable` n’est pas pris en charge.
+ `exclusiveMinimum` n’est pas pris en charge par API Gateway.
+ Les balises `maxItems` et `minItems` ne sont pas incluses dans une [validation de demande simple](api-gateway-method-request-validation.md). Pour contourner ce problème, mettez à jour le modèle après l’importation avant d’effectuer la validation.
+ Pour OpenAPI 3.0, `oneOf`, `anyOf` et `allOf` ne peuvent pas utiliser `$ref` dans une définition du même schéma. Vous pouvez soit saisir directement votre schéma, soit définir une ressource de modèle API Gateway distincte. Pour de plus amples informations, veuillez consulter [Création de modèles plus complexes](models-mappings-models.md#api-gateway-request-validation-model-more-complex).
+ `oneOf` n’est pas pris en charge pour la génération d’OpenAPI 2.0 ou du kit SDK.
+ Le champ `readOnly` n’est pas pris en charge.
+ `$ref` ne peut pas être utilisé pour référencer d’autres fichiers.
+ Les définitions de réponse sous la forme `"500": {"$ref": "#/responses/UnexpectedError"}` ne sont pas prises en charge dans la racine du document OpenAPI. Pour contourner ce problème, remplacez la référence par le schéma en ligne.
+ Les nombres de type `Int32` ou `Int64` ne sont pas pris en charge. Voici un exemple :
```
"elementId": {
"description": "Working Element Id",
"format": "int32",
"type": "number"
}
```
+ Le type de format décimal (`"format": "decimal"`) n’est pas pris en charge dans une définition de schéma.
+ Dans les réponses de méthode, la définition de schéma doit être de type objet et ne peut pas avoir l’un des types primitifs. Par exemple, `"schema": { "type": "string"}` n’est pas pris en charge. Cependant, vous pouvez contourner ce problème à l’aide du type d’objet suivant :
```
"schema": {
"$ref": "#/definitions/StringResponse"
}
"definitions": {
"StringResponse": {
"type": "string"
}
}
```
+ API Gateway n’utilise pas la sécurité de niveau racine définie dans la spécification OpenAPI. Par conséquent, la sécurité doit être définie au niveau de l’opération pour être appliquée correctement.
+ Le mot-clé `default` n’est pas pris en charge.
+ API Gateway adopte les restrictions et limitations suivantes lors de la gestion des méthodes avec intégration Lambda ou HTTP.
+ Les noms d’en-tête et les paramètres de requête sont traités de manière sensible à la casse.
+ Le tableau suivant répertorie les en-têtes qui peuvent être abandonnés, remappés ou modifiés autrement lorsqu’ils sont envoyés au point de terminaison d’intégration ou renvoyés par le point de terminaison d’intégration. Dans ce tableau :
+ `Remapped` signifie que le nom d’en-tête `` est remplacé par `X-Amzn-Remapped-`.
`Remapped Overwritten` signifie que le nom d’en-tête `` est remplacé par `X-Amzn-Remapped-` et que la valeur est écrasée.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/apigateway/latest/developerguide/api-gateway-known-issues.html)
\$1 L’en-tête `Authorization` est supprimé s’il contient une signature [Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) ou si une autorisation `AWS_IAM` est utilisée.
+ Le kit SDK Android d’une API générée par API Gateway utilise la classe `java.net.HttpURLConnection`. Cette classe lève une exception non prise en charge, sur les appareils Android 4.4 et version antérieures, dans le cas d’une réponse 401 résultant du remappage de l’en-tête `WWW-Authenticate` en `X-Amzn-Remapped-WWW-Authenticate`.
+ Contrairement aux API Java, Android et iOS générées par API Gateway, le JavaScript SDK SDKs d'une API générée par API Gateway ne prend pas en charge les nouvelles tentatives pour des erreurs de niveau 500.
+ Le test d’appel d’une méthode utilise le type de contenu `application/json` par défaut et ignore les spécifications de tous les autres types de contenu.
+ Lorsque vous envoyez des demandes à une API en transmettant l’en-tête `X-HTTP-Method-Override`, API Gateway remplace la méthode. Par conséquent, pour que l’en-tête soit transmis au backend, elle doit être ajoutée à la demande d’intégration.
+ Lorsqu’une demande contient plusieurs types de supports dans son en-tête `Accept`, API Gateway respecte uniquement le premier type de support `Accept`. Lorsque vous ne pouvez pas contrôler l’ordre des types de supports `Accept` et que le type de support de votre contenu binaire n’est pas le premier de la liste, vous pouvez ajouter le premier type de support `Accept` dans la liste `binaryMediaTypes` de votre API. API Gateway retourne alors votre contenu sous forme binaire. Par exemple, pour envoyer un fichier JPEG en utilisant un élément `![]()
` dans un navigateur, ce dernier peut envoyer `Accept:image/webp,image/*,*/*;q=0.8` dans une demande. Si vous ajoutez `image/webp` à la liste `binaryMediaTypes`, le point de terminaison reçoit le fichier JPEG sous forme binaire.
+ La personnalisation de la réponse de passerelle par défaut pour `413 REQUEST_TOO_LARGE` n’est actuellement pas prise en charge.
+ API Gateway inclut un en-tête `Content-Type` pour toutes les réponses d’intégration. Par défaut, le type de contenu est `application/json`.