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 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. S’il s’agit d’un quota par API, il ne peut être augmenté que pour certaines API spécifiques, et non pour toutes les API d’un compte.
Pour plus d’informations sur les quotas au niveau du compte consultez Quotas Amazon API Gateway.
| 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 |
| Noms de domaine personnalisés privés par compte et par région | 50 | Oui |
| API régionales par région | 600 | Non |
| API optimisées pour la périphérie par région | 120 | Non |
| API privées par compte et par région | 600 | Non |
| Associations d’accès aux noms de domaine par compte | 100 | Oui |
| Mappages d'API à plusieurs niveaux par domaine | 200 | Non |
| Règles de routage par domaine | 50 | Oui |
| 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 pour une API régionale | 10240 | Non |
| Longueur, en caractères, de la politique de ressources API Gateway | 8192 | Oui |
| Clés d’API par compte et par région | 10 000 | Non |
| Certificats de client par compte et par région | 60 | Oui |
| Mécanismes d’autorisation par API (AWS Lambda et Amazon Cognito) | 10 |
Oui Pour augmenter ce quota, contactez le Centre de support AWS |
| Parties de la documentation par API | 2000 |
Oui Pour augmenter ce quota, contactez le Centre de support AWS |
| Ressources par API | 300 | Oui |
| Étapes par API | 10 | Oui |
| 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 |
| Plans d’utilisation par clé d’API | 10 | Oui |
| Liens VPC par compte et par région | 20 | Oui |
| 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 les API régionales | 50 millisecondes - 29 secondes pour tous les types d’intégration, y compris Lambda, proxy Lambda, HTTP, proxy HTTP et intégrations AWS. | Oui * |
| Délai d’intégration pour les API optimisées pour la périphérie | 50 millisecondes - 29 secondes pour tous les types d’intégration, y compris Lambda, proxy Lambda, HTTP, proxy HTTP et intégrations AWS. | Non |
| Délai d’intégration pour les API privées | 50 millisecondes - 29 secondes pour tous les types d’intégration, y compris Lambda, proxy Lambda, HTTP, proxy HTTP et intégrations AWS. | Oui * |
| 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 #foreach ... #end 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 |
| 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 ou de restapi:put | 6 Mo | Non |
* 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.
- API par région
-
Pour réduire le nombre d’API par région, exportez toutes les API inutilisées, puis supprimez-les d’API Gateway. Pour plus d’informations, consultez Exportation d’une API REST à partir d’API Gateway.
- Étapes par API
-
Pour réduire le nombre d’étapes par API, divisez votre API en plusieurs API.
- Ressources par API
-
Utilisez les chemins
{proxy+}pour réduire le nombre de ressources. Pour plus d’informations, consultez Configuration de l'intégration de proxy avec une ressource de proxy. - 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=documentationlorsque vous importez votre API. Pour plus d’informations, consultez Importation de la documentation d’une API.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 plus d’informations, consultez Représentation de la documentation de l’API dans API Gateway.
- Longueur, en caractères, de la politique de ressources API Gateway
-
Pour réduire la longueur d’une politique de ressources, utilisez AWS WAFV2 pour protéger votre API. Pour plus d’informations, consultez Utilisation d’AWS WAF pour protéger vos API REST dans API Gateway.
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 API. Nous vous déconseillons d’utiliser une même clé d’API pour plusieurs plans d’utilisation.
