Quotas et limites

Cette page décrit les limites de quota d'API Gateway.

Limites sur les API, les configurations d'API et les passerelles

API Gateway applique les limites suivantes sur les API, les configurations d'API et les passerelles :

API : 50 au total
Configurations d'API : 100 par API
Passerelles : 50 par région

Si vous essayez de créer une deuxième configuration d'API avant la fin de la création de la première configuration d'API pour la même API, il est possible qu'une des configurations ou les deux ne soient pas disponibles pour une utilisation ultérieure dans une passerelle.

Limites de débit des requêtes

La limite de débit par défaut est fixée à 10 000 000 d'unités de quota pour 100 secondes par projet producteur de services. Une unité de quota est consommée pour chaque appel à services.check et pour chaque opération consignée par services.report.

Limites de taille de la charge utile

Les limites suivantes s'appliquent spécifiquement à la taille maximale de la charge utile pour le trafic via des passerelles déployées :

Limite	Volume
Taille d'une requête	32 Mo
Taille d'une réponse	32 Mo
Taille de la réponse du transcodage gRPC	1 méga-octet
Taille de la requête de transcodage gRPC	1 méga-octet

Le streaming n'est pas pris en charge.

Limites de taille des en-têtes

Les limites suivantes s'appliquent spécifiquement à la taille maximale de l'en-tête pour le trafic via des passerelles déployées :

Limite	Montant
Taille des en-têtes de requête	60 kilo-octets

Le service de backend appelé par API Gateway peut avoir des limites inférieures.

Augmenter le quota

Les demandes d'ajustement de quotas Cloud sont soumises à un examen. Si votre demande nécessite un examen, vous recevrez un e-mail confirmant qu'elle a bien été transmise. Si vous avez besoin d'aide, répondez à l'e-mail. Après examen de votre demande, vous recevrez une notification par e-mail indiquant si votre demande a été approuvée. Vous pouvez demander un ajustement de quota à l'aide de la console Google Cloud , de l'API Cloud Quotas ou de Google Cloud CLI. Les instructions suivantes montrent comment demander une nouvelle valeur de quota à l'aide de la console Google Cloud ou en envoyant une requête REST à l'API Cloud Quotas.

Console

Pour demander un ajustement de quota, procédez comme suit :

Dans la console Google Cloud , accédez à la page IAM et administration > Quotas et limites du système :
Accéder à la page Quotas et limites du système
Si vous êtes invité à sélectionner un projet, choisissez celui que vous souhaitez ajuster.
Recherchez le quota que vous souhaitez ajuster, puis ouvrez la boîte de dialogue Modifications de quotas :
- Quotas non inclus dans le tableau :
  - Recherchez votre quota dans le champ de recherche Filtre. Ne spécifiez pas la région ni la zone (le cas échéant), car les quotas qui n'ont pas de valeurs d'utilisation ou ajustées ne s'affichent pas dans le tableau.
  - Recherchez une entrée pour votre quota dans le tableau. Il peut s'agir de l'entrée par défaut ou de n'importe quelle entrée avec un historique, quelle que soit la région ou la zone.
  - Sur la ligne de l'entrée, cliquez sur Autres actions > Configurer des régions/zones supplémentaires.
  - Sélectionnez la région ou la zone que vous souhaitez ajuster. Cliquez sur Modifier.
- Tous les autres quotas :
  - Recherchez votre quota dans le champ de recherche Filtre.
  - Sur la ligne de l'entrée, cochez la case correspondant à votre quota.
  - Cliquez sur Modifier ().
La boîte de dialogue Modifications de quotas s'affiche.
Si le lien Demander un quota supérieur s'affiche au-dessus du champ Nouvelle valeur et que vous souhaitez augmenter la valeur de votre quota au-delà du nombre indiqué à l'écran, cliquez sur le lien. Remplissez le formulaire, envoyez-le et ignorez les étapes restantes. Sinon, continuez à suivre ce guide.
Dans le champ Nouvelle valeur, saisissez la valeur de quota que vous souhaitez obtenir. Si un champ Description de la demande s'affiche, saisissez une description. Cliquez sur OK.
- Si une case à cocher contenant le texte "Je comprends que cette demande supprimera tous les remplacements" s'affiche, cela signifie que votre quota est inférieur à la valeur par défaut. Si vous ajustez la valeur du quota à la valeur par défaut ou au-delà, le remplacement est supprimé. Pour continuer, cochez la case. En savoir plus sur les quotas de remplacement
Si un bouton Suivant s'affiche, cliquez sur Suivant, puis renseignez vos coordonnées sur l'écran suivant.
Cliquez sur Envoyer la requête.

Si vous constatez que vous ne pouvez pas demander un ajustement dans la console, demandez l'augmentation auprès de Cloud Customer Care.

Pour en savoir plus sur le fonctionnement du processus d'augmentation des quotas, consultez À propos des ajustements de quotas.

Regrouper des demandes d'ajustement de quota

Vous pouvez regrouper des demandes d'ajustement de quota en cochant la case à côté de chaque quota que vous souhaitez inclure. Toutefois, le traitement par lot des demandes peut augmenter le délai nécessaire à Google Cloud pour examiner votre demande.

Pour réduire le temps d'examen, regroupez les demandes d'ajustement de quota par produit et par zone géographique. Par exemple, si vous souhaitez demander des ajustements pour les quotas de réseau et de VM Compute Engine, créez une requête pour les quotas de réseau et une autre pour les quotas de VM Compute Engine.

REST

Pour demander un ajustement de quota à partir de l'API Cloud Quotas, utilisez l'exemple de code suivant. Renseignez les espaces réservés modifiables avec vos valeurs. Pour en savoir plus sur les champs d'espace réservé, consultez les descriptions qui suivent l'exemple de code.

POST projects/PROJECT_NUMBER/locations/global/quotaPreferences?quotaPreferenceId=QUOTA_PREFERENCE_ID {
    "service": "SERVICE_ID",
    "quotaId": "QUOTA_ID",
    "quotaConfig": { "preferredValue": "NEW_QUOTA_VALUE" },
    "dimensions": { "DIMENSION_1": "VALUE_1", "DIMENSION_2": "VALUE_2" },
    "justification": "JUSTIFICATION",
    "contactEmail": "EMAIL"
}

Remplacez les éléments suivants :

PROJECT_NUMBER : numéro de votre projet Google Cloud . Vous pouvez trouver le numéro de votre projet sur la page Bienvenue de la console Google Cloud ou en exécutant la commande gcloud CLI suivante :
```
PROJECT=$(gcloud info --format='value(config.project)')
gcloud projects describe ${PROJECT} --format="value(projectNumber)"
```
QUOTA_PREFERENCE_ID : ID de la préférence de quota que vous mettez à jour.
QUOTA_ID : ID du quota que vous mettez à jour.
SERVICE_ID : ID du Google Cloud auquel appartient le quota que vous ajustez. Il s'agit généralement de SERVICE_NAME.googleapis.com. Par exemple, le nom du service Compute Engine est compute.googleapis.com.
DIMENSION_1 : type de dimension que vous souhaitez ajuster (par exemple, region ou zone). Vous pouvez inclure plusieurs dimensions. Séparez chaque dimension par une virgule après sa valeur (par exemple, VALUE_1). Pour ajuster toutes les dimensions du quota, omettez cette ligne.
VALUE_1 : valeur de la dimension précédente. Par exemple, si la dimension précédente est region, saisissez une région telle que us-central1.
JUSTIFICATION : motif de la requête.
EMAIL : adresse e-mail pouvant être utilisée comme contact, au cas où Google Cloud aurait besoin de plus d'informations pour prendre une décision avant d'accorder un quota supplémentaire.

Exemple de requête

Voici un exemple de demande d'augmentation de la valeur du quota PUS-PER-GPU-FAMILY-per-project-region de Compute Engine. Elle demande une valeur de quota de 100 pour les machines de la famille de GPU NVIDIA_H100 qui se trouvent dans la région us-central1.

POST projects/123/locations/global/quotaPreferences?quotaPreferenceId=my_quota_preference_ID {
    "service": "compute.googleapis.com",
    "quotaId": "GPUS-PER-GPU-FAMILY-per-project-region",
    "quotaConfig": { "preferredValue": 100 },
    "dimensions": { "region": "us-central1", "gpu_family": "NVIDIA_H100" },
    "justification": "My justification.",
    "contactEmail": "222larabrown@gmail.com"
}