Utiliser des quotas

Google Cloud Platform (GCP) impose des quotas sur l'utilisation des ressources aux propriétaires de projets, en définissant une limite inconditionnelle de l'utilisation d'une ressource GCP particulière par votre projet. Nous imposons des quotas sur deux types d'utilisations de ressources :

  • Un quota de débit, comme les requêtes API par jour. Ce quota est réinitialisé après un délai spécifié, tel qu'une minute ou un jour.
  • Un quota d'allocation, comme le nombre de machines virtuelles ou d'équilibreurs de charge utilisés par votre projet. Ce quota ne se réinitialise pas avec le temps, mais il doit être explicitement libéré lorsque vous ne souhaitez plus utiliser la ressource (par exemple, lorsque vous supprimez un cluster GKE).

Des quotas sont appliqués pour différentes raisons, par exemple pour préserver la communauté des utilisateurs de GCP en empêchant les pics d'utilisation imprévus. Les quotas vous aident également à gérer vos ressources. Par exemple, vous pouvez définir vos propres limites d'utilisation du service dans le cadre de votre quota fourni par Google lors des processus de développement et de test de vos applications. Chaque limite de quota est exprimée en fonction d'une ressource dénombrable donnée, des requêtes API par jour au nombre d'équilibreurs de charge utilisés par votre application.

Tous les projets ne bénéficient pas des mêmes quotas pour les mêmes services. Par exemple, si vous utilisez un compte d'essai gratuit pour explorer la plate-forme, votre quota peut être très limité. Certains services ne bénéficient de quotas supérieurs que lorsque vous activez la facturation pour votre projet. Au fur et à mesure que votre utilisation de Google Cloud Platform s'accroît, vos quotas peuvent augmenter en conséquence. Vous pouvez également demander des quotas supplémentaires si nécessaire. Vous pouvez aussi configurer la surveillance et les alertes dans Stackdriver pour vous avertir d'un comportement inhabituel d'utilisation des quotas ou lorsque les quotas sont épuisés.

Cette page explique comment utiliser les quotas dans vos projets, y compris comment rechercher et modifier les limites de quota existantes, comment demander un quota supérieur et comment surveiller l'utilisation des quotas.

Afficher votre quota

Vous pouvez afficher les limites de quota actuelles dans Google Cloud Console des deux manières suivantes :

  • Consultez la page Quotas pour obtenir une liste relative à l'utilisation et aux limites de quota de tous vos projets.

  • Accédez à la console pour obtenir des informations sur le quota d'une API spécifique, y compris sur l'utilisation des ressources au fil du temps.

En outre, certains services offrent un accès en ligne de commande aux informations relatives à l'utilisation des quotas et des ressources. Par exemple, Compute Engine vous permet d'accéder aux informations sur les quotas à l'aide de la commande gcloud compute.

Découvrez comment surveiller votre utilisation de quotas dans la section Surveillance de l'utilisation de quotas ci-dessous.

Afficher tous les quotas de projet

Pour afficher les quotas (utilisation et limites des quotas) de toutes les ressources de votre projet, procédez comme suit :

  1. Accédez à la rubrique "Quotas" de la section "IAM et administration" dans la console GCP.
  2. Dans la liste des projets, sélectionnez un projet ou créez-en un. La page "Quotas" du projet sélectionné s'affiche. Elle répertorie une ligne pour chaque type de quota disponible dans chaque service.
  3. (Facultatif) Triez et filtrez les résultats pour trouver les informations dont vous avez besoin :

    • Utilisez les filtres en haut de la page pour ajuster la liste par Type de quota, Service, Métrique et/ou Emplacement.
    • Par défaut, la liste est triée de manière à afficher votre quota le plus utilisé en premier (en fonction du pic d'utilisation au cours des sept derniers jours). Vous pouvez ainsi afficher les limites qui risquent d'être dépassées. Pour afficher le quota le moins utilisé en premier, sélectionnez la flèche Pic d'utilisation sur 7 jours.

La liste indique également votre utilisation actuelle d'un quota particulier. Pour le quota d'allocation, il s'agit tout simplement de l'utilisation actuelle d'une ressource à proprement parler. Pour le quota de débit quotidien, il s'agit de l'utilisation jusqu'à un instant T de la journée en cours. Pour le quota de débit à la minute ou par tranche de 100 secondes, il s'agit de l'utilisation moyenne au cours des dernières 24 heures.

Pour en savoir plus sur les quotas d'un service spécifique et leur signification, consultez la documentation du service donné : par exemple, le quota de Compute Engine est décrit dans la section Quotas de ressources.

Quota spécifique à l'API

Pour afficher des informations plus détaillées sur le quota d'une API spécifique, y compris son utilisation dans le temps, consultez la page sur le quota de l'API dans la console. Selon l'API, ces limites peuvent inclure des requêtes par jour, des requêtes par minute, et des requêtes par minute et par utilisateur. Certaines API définissent des limites très basses tant que vous n'avez pas activé la facturation sur votre projet.

Pour afficher les limites actuelles d'une API spécifique, procédez comme suit :

  1. Accédez à la page Tableau de bord API et services de la console GCP.
  2. Dans la liste des projets, sélectionnez un projet ou créez-en un.
  3. Cliquez sur le nom de l'API qui vous intéresse.
  4. Cliquez sur Quotas. Les noms des quotas et les limites correspondantes définis pour l'API sélectionnée s'affichent sur la page "Quotas". Google impose ces limites par défaut. Si vous souhaitez définir une limite inférieure, vous pouvez consulter les instructions relatives à la limitation de l'utilisation. Si Google n'impose pas de limite pour un quota donné, la limite est affichée comme illimitée.

Tous les quotas ne s'affichent pas sur la page de quota spécifique à une API. Par exemple, les requêtes vers l'API Compute Engine ont une page de quota spécifique, mais cela n'inclut pas l'utilisation des ressources de calcul Compute Engine (quota d'allocation). En outre, si vous utilisez le service dans plusieurs zones, la page de quota spécifique à l'API ne présente pas les limites et l'utilisation régionales ou zonales des quotas. Pour obtenir la liste complète des quotas de votre projet (qui vous permet également d'appliquer un filtre par emplacement), vous devez consulter la page Quotas du projet.

Gérer votre quota

Selon l'utilisation de vos ressources, vous pouvez ajuster les limites de quota de votre projet à la hausse ou à la baisse. Cette section décrit comment modifier les limites de quota fournies.

Demander un quota supérieur

Vous pouvez demander un changement de quota pour la plupart des services facturables avec une limite de quota, comme suit :

  1. Sur la page Quotas, cochez les cases pour sélectionner un ou plusieurs quotas à modifier, puis cliquez sur MODIFIER LES QUOTAS. Vous devez activer la facturation sur le projet pour pouvoir cocher les cases.
  2. Dans le panneau "Modifier les quotas" de droite, remplissez le formulaire avec votre nom, votre adresse e-mail et votre numéro de téléphone, puis cliquez sur Suivant.
  3. Dans le panneau "Modifier les quotas", sélectionnez le service pour développer la vue, puis modifiez les quotas de ce service en fonction de la limite souhaitée. Cliquez sur OK.
  4. Répétez l'opération pour modifier les quotas dans chacun des services sélectionnés.
    • Un service avec une icône d'alerte (error) signifie qu'il n'a pas encore été modifié ou qu'un champ n'a pas été renseigné.
    • Vous pouvez ajouter davantage de quotas à modifier en les sélectionnant dans la liste de gauche.
    • Vous pouvez supprimer un service du panneau "Modifier les quotas" en cliquant sur l'icône de suppression (delete).
  5. Lorsque vous avez terminé de modifier les quotas, cliquez sur Envoyer la requête.

Vous recevez rapidement une réponse à vos demandes de quotas GCP, dans un délai de deux jours ouvrés. Vous devez recevoir un e-mail de confirmation de l'assistance GCP pour votre demande. Si vous avez besoin d'aide supplémentaire, vous pouvez répondre à cet e-mail. Notez que les augmentations de quota importantes peuvent prendre plus de temps pour être approuvées.

Limiter l'utilisation des ressources

Si vous souhaitez limiter l'utilisation d'une ressource particulière, vous devez définir vos propres limites de quota. Par exemple, pour éviter de vous faire facturer une utilisation au-delà des limites d'utilisation gratuite, vous pouvez définir un nombre maximal de requêtes par jour. Le moyen le plus simple de limiter le quota consiste à modifier les limites sur la page de quota spécifique à l'API.

  1. Accédez à la page de quota spécifique à l'API dont vous souhaitez limiter l'utilisation.
  2. Sur la ligne du quota que vous souhaitez modifier, cliquez sur l'icône de modification (edit), puis entrez votre quota total préféré, dans la limite spécifiée par Google.
  3. Cliquez sur Enregistrer pour enregistrer les modifications.

Si vous souhaitez limiter un quota qui ne s'affiche pas sur cette page (comme les VM) ou définir une limite supérieure à la limite maximale fournie, vous devez modifier vos limites en suivant le processus de modification du quota décrit dans Demander un quota supérieur.

Surveiller des métriques de quota (bêta)

La console Google Cloud Console vous donne accès aux informations générales sur les quotas, mais elle vous permet aussi de surveiller l'utilisation et les erreurs de quota de manière plus approfondie à l'aide de l'API et de l'interface utilisateur Stackdriver, avec les métriques de quota apparaissant dans l'explorateur de métriques. Vous pouvez ensuite utiliser ces métriques pour créer des tableaux de bord et des alertes personnalisés, vous permettant de surveiller l'utilisation des quotas dans le temps et de recevoir des alertes lorsque vous approchez, par exemple, d'une limite de quota.

Stackdriver accepte une grande variété de métriques, que vous pouvez associer à des filtres et des agrégations pour créer de nouvelles vues pertinentes de votre utilisation de quotas. Par exemple, vous pouvez associer une métrique du nombre d'utilisations de quotas d'allocation à un filtre quota_metrics sur les Cloud TPU.

Accéder à l'explorateur de métriques

Pour afficher les métriques de quota dans l'explorateur de métriques, sélectionnez d'abord le quota du client comme type de ressource. Sélectionnez ensuite Utilisation du quota d'allocation ou Utilisation du quota de débit pour surveiller l'utilisation de quotas d'allocation ou de débit. Vous pouvez ensuite éventuellement utiliser les options de filtre et d'agrégation pour affiner davantage vos données. Une fois que vous avez trouvé les informations d'utilisation de quotas souhaitées, vous pouvez utiliser Stackdriver pour créer des tableaux de bord et des alertes personnalisés vous permettant de continuer à surveiller et à maintenir une application robuste. De même, pour afficher les erreurs de dépassement de quota, vous devez d'abord sélectionner le quota du client comme type de ressource, puis sélectionner l'erreur de dépassement de quota. Consultez les pages suivantes pour obtenir la marche à suivre :

Vous pouvez trouver une documentation de référence détaillée sur les métriques de quota dans la documentation Stackdriver Monitoring.

Tous les services ne sont pas compatibles avec les métriques de quota. Les services qui ne sont pas compatibles avec les métriques de quota n'apparaissent pas sous Quota du client dans Stackdriver.

Erreurs de quota

Si votre projet dépasse un quota particulier lors de l'utilisation d'un service, la plate-forme affiche une erreur.

En général, GCP renvoie un code d'erreur HTTP 429 si vous utilisez HTTP/REST pour accéder au service, ou ResourceExhausted si vous utilisez gRPC. La façon dont cette erreur s'affiche dépend du service.

Si vous utilisez Stackdriver, vous pouvez vous en servir pour identifier le quota associé à l'erreur, puis créer des alertes personnalisées lorsque vous obtenez une erreur de quota, comme décrit dans la section Surveiller des métriques de quota. Notez que la métrique d'erreur de quota est uniquement disponible en tant que critère de sélection dans les tableaux de bord personnalisés Stackdriver une fois qu'un projet a reçu des erreurs de dépassement de quota.

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…