Quotas Amazon API Gateway et remarques importantes - Amazon API Gateway

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 et remarques importantes

Sauf indication contraire, les quotas peuvent être augmentés sur simple demande. Pour demander une augmentation de quota, vous pouvez utiliser Service Quotas ou contacter le Centre de support AWS.

Lorsque l'autorisation est activée pour une méthode, la longueur maximale de l'ARN de cette méthode (par exemple, arn:aws:execute-api:{region-id}:{account-id}:{api-id}/{stage-id}/{method}/{resource}/{path}) est de 1 600 octets. Les valeurs des paramètres de chemin (dont la taille est déterminée au moment de l'exécution) peuvent entraîner un dépassement de la limite pour la longueur de l'ARN. Lorsque cela se produit, le client API reçoit une réponse 414 Request URI too long.

Note

Cela limite la longueur de l'URI lorsque les stratégies de ressources sont utilisées. Dans le cas d'API privées où une stratégie de ressource est requise, la longueur de l'URI de toutes les API privées est limitée.

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é
Quota de restriction par compte, par région sur les API HTTP, les API REST, les API WebSocket et les API de rappel WebSocket 10 000 demandes par seconde (RPS) avec une capacité de transmission en mode rafale supplémentaire fournie par l'algorithme de compartiment à jeton, en utilisant une capacité de compartiment maximale de 5 000 demandes. *
Note

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
API régionales 600 Non
API optimisées pour les périphériques 120 Non

* Pour les régions Afrique (Le Cap) et Europe (Milan), le quota de restriction par défaut est de 2500 RPS et le quota en mode rafale par défaut est de 1250 RPS.

Quotas API HTTP

Les quotas suivants s'appliquent à la configuration et à l'exécution d'une API HTTP dans API Gateway.

Ressource ou opération Quota par défaut Peut être augmenté
Routes par API 300 Oui
Intégrations par API 300 Non
Délai d'intégration maximal 30 secondes Non
Étapes par API 10 Oui
Mappages d'API à plusieurs niveaux par domaine 200 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
Taille du modèle de journal d'accès 3 KO Non
Entrée du journal Amazon CloudWatch Logs 1 Mo Non
Mécanismes d'autorisation par API 10 Oui
Audiences par mécanisme d'autorisation 50 Non
Portées par itinéraire 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
Lien Sous-réseaux par VPC 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

Quotas API Gateway concernant la configuration et l'exécution d'une API WebSocket

Les quotas suivants s'appliquent à la configuration et à l'exécution d'une API WebSocket dans Amazon API Gateway.

Ressource ou opération Quota par défaut Peut être augmenté
Nouvelles connexions par seconde et par compte (sur toutes les API WebSocket) par région 500 Oui
Connexions simultanées Ne s'applique pas * Ne s'applique pas
AWS LambdaMécanismes d'autorisations par API 10 Oui
AWS LambdaTaille du résultat du mécanisme d'autorisation 8 Ko Non
Routes par API 300 Oui
Intégrations par API 300 Oui
Délai d’intégration 50 millisecondes - 29 secondes pour tous les types d’intégration, y compris Lambda, proxy Lambda, HTTP, proxy HTTP et intégrations AWS. Non
Étapes par API 10 Oui
Taille de trame WebSocket 32 Ko Non
Taille de la charge utile des messages 128 Ko ** Non
Durée de la connexion de l'API WebSocket 2 heures Non
Délai d'expiration de connexion inactive 10 minutes Non
Longueur, en caractères, de l’URL pour une API WebSocket 4096 Non

* 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.

** En raison du quota établi pour la taille de trame WebSocket de 32 Ko, un message supérieur à 32 Ko doit être scindé en plusieurs trames, de chacune 32 Ko ou moins. 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.

Quotas API Gateway pour la configuration et l'exécution d'une API REST

Les quotas suivants s'appliquent à la configuration et à l'exécution d'une API REST dans Amazon API Gateway.

Ressource ou opération Quota par défaut Peut être augmenté
Noms de domaine personnalisés par compte et par région 120 Oui
Mappages d'API à plusieurs niveaux par domaine 200 Non
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
API privées par compte et par région. 600 Non
Longueur, en caractères, de la stratégie 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
Parties de la documentation par API 2000 Oui
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é 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 50 millisecondes - 29 secondes pour tous les types d’intégration, y compris Lambda, proxy Lambda, HTTP, proxy HTTP et intégrations AWS. Ne s'applique pas aux limites inférieures ou supérieures.
Taille combinée totale de toutes les valeurs d'en-tête 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
Longueur de l'ARN d'une méthode avec autorisation 1 600 octets Non
Paramètres de limitation au niveau de la méthode pour une étape dans un plan d'utilisation 20 Oui
Taille de modèle par API 400 Ko Non

Pour restapi:import ou restapi:put, la taille maximum du fichier de définition d'API est de 6 Mo.

Toutes les limites par API ne peuvent être augmentées que sur des API spécifiques.

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'aide de la AWS CLI, de la console API Gateway, ou de l'API REST API Gateway et de ses SDK. Ces quotas ne peuvent pas être augmentés.

Action Quota par défaut Peut être augmenté
CreateApiKey 5 demandes toutes les secondes par compte Non
CreateDeployment 1 demande toutes les 5 secondes par compte Non
CreateDocumentationVersion 1 demande toutes les 20 secondes par compte Non
CreateDomainName 1 requête toutes les 30 secondes par compte Non
CreateResource 5 demandes toutes les secondes par compte Non
CreateRestApi
API régionale ou privée
  • 1 requête toutes les 3 secondes par compte

API optimisée pour les périphériques
  • 1 requête toutes les 30 secondes par compte

Non
CreateVpcLink (V2) 1 demande toutes les 15 secondes par compte Non
DeleteApiKey 5 demandes toutes les secondes par compte Non
DeleteDomainName 1 requête toutes les 30 secondes par compte Non
DeleteResource 5 demandes toutes les secondes par compte Non
DeleteRestApi 1 requête toutes les 30 secondes par compte Non
GetResources 5 requêtes toutes les 2 secondes par compte Non
DeleteVpcLink (V2) 1 requête toutes les 30 secondes par compte Non
ImportDocumentationParts 1 requête toutes les 30 secondes par compte Non
ImportRestApi
API régionale ou privée
  • 1 requête toutes les 3 secondes par compte

API optimisée pour les périphériques
  • 1 requête toutes les 30 secondes par compte

Non
PutRestApi 1 requête toutes les secondes par compte Non
UpdateAccount 1 demande toutes les 20 secondes par compte Non
UpdateDomainName 1 requête toutes les 30 secondes par compte Non
UpdateUsagePlan 1 demande toutes les 20 secondes par compte 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