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 configurer et exécuter 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, voir. 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 |
Régional APIs par région | 600 | Non |
Optimisé en périphérie 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 |
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 |
Autorisateurs par API (AWS Lambda et Amazon Cognito) | 10 |
Oui Pour augmenter ce quota, contactez le AWS Support Center |
Parties de la documentation par API | 2000 |
Oui Pour augmenter ce quota, contactez le AWS Support Center |
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 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 * |
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 * |
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 |
Longueur de l'ARN de la méthode | 1600 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 renvoie une 414 Request URI too long réponse. |
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 AWS Support Center |
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 de connexion inactive | 310 secondes | Non |
Taille maximale du fichier de définition d'API lors de l'utilisation de restapi:import ou 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 augmenter le délai d'intégration à plus de 29 secondes, mais cela peut nécessiter une réduction du quota d'accélération de votre compte au niveau de la région.
Les meilleures pratiques pour réduire vos quotas
Les bonnes pratiques suivantes peuvent vous aider à réduire votre nombre actuel de ressources afin d'éviter d'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.
- Étapes par API
-
Pour réduire le nombre d'étapes par API, divisez votre API en plusieurs étapes APIs.
- Ressources par API
-
Utilisez
{proxy+}
des chemins pour réduire le nombre de ressources. Pour de plus amples informations, veuillez consulter 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 à niveaux uniques, tels que.
/prod
Les mappages d'API à un seul niveau ne sont pas pris en compte dans le quota de mappages d'API. - Mécanismes d’autorisation par API
Pour réduire le nombre d'autorisateurs par API, réutilisez les autorisateurs dans toutes les méthodes d'API.
- Parties de la documentation par API
-
Pour réduire le nombre de parties de documentation par API, utilisez-le
ignore=documentation
lorsque vous importez votre API. Pour de plus amples informations, veuillez consulter Importation de la documentation d’une API.Vous pouvez également utiliser l'héritage de contenu pour permettre à certaines parties de la documentation d'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.
- 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.
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 de partager une clé d'API entre plusieurs plans d'utilisation.