Cette page explique comment gérer vos quotas Cloud Key Management Service. Pour en savoir plus sur les quotas associés à Cloud KMS, consultez la page Quotas.
Avant de commencer
Les autorisations suivantes sont requises pour afficher les quotas de projets:
resourcemanager.projects.get
monitoring.timeSeries.list
serviceusage.services.list
serviceusage.quotas.get
L'autorisation serviceusage.quotas.update est requise pour modifier les quotas de projet.
Cette page vous permet de consulter les détails des quotas de l'API Cloud KMS.
Pour afficher les quotas d'un autre projet, sélectionnez le projet souhaité dans l'en-tête de la console Trusted Cloud .
Pour filtrer par type de quota, cliquez dans la barre Filtre, puis sélectionnez Quota dans la liste des propriétés, puis le quota souhaité.
Pour filtrer par région, cliquez dans la barre Filtre, puis sélectionnez Dimensions (par exemple, emplacement) dans la liste des propriétés, puis saisissez le nom de la région souhaitée.
Si Cloud KMS refuse une requête parce que la limite du quota concerné a été atteinte, il renvoie une erreur RESOURCE_EXHAUSTED. Pour les requêtes effectuées à l'aide de l'API REST Cloud KMS, l'erreur RESOURCE_EXHAUSTED est associée au code d'état HTTP 429. Étant donné que les quotas de projets d'hébergement Cloud KMS sont appliqués sur une base par seconde, les erreurs RESOURCE_EXHAUSTED occasionnelles pour les clés HSM ou EKM peuvent être résolues en réessayant la seconde suivante.
Les erreurs RESOURCE_EXHAUSTED récurrentes indiquent que votre projet dépasse régulièrement un ou plusieurs de ses quotas. Pour résoudre ce problème, vous pouvez essayer l'une des solutions suivantes, ou les deux:
Réduisez la fréquence à laquelle vos projets envoient des requêtes qui utilisent des ressources Cloud KMS.
Utilisez des projets distincts pour vos ressources, le cas échéant, afin que plusieurs ressources ne partagent pas les mêmes quotas.
Appel des quotas de projet : si vous disposez d'un seul projet contenant plusieurs ressources qui utilisent l'API Cloud KMS à des taux de requête élevés, envisagez de déplacer les ressources vers leurs propres projets afin qu'elles ne partagent pas la limite de 60 000 RPM.
Quotas de projets d'hébergement : si vous disposez d'un seul projet contenant des clés Cloud HSM ou Cloud EKM compatibles avec des ressources distinctes avec des taux de RPS élevés, envisagez de diviser les clés Cloud KMS en projets distincts en fonction de détails tels que leur priorité ou leur charge de travail. De cette façon, moins de clés partagent les mêmes quotas Cloud HSM et Cloud EKM.
Ajoutez un mécanisme de délai avant réessai à votre client pour gérer les erreurs RESOURCE_EXHAUSTED.
Demander des quotas Cloud KMS plus élevés
Dans la Trusted Cloud console, accédez à la page Détails de l'API/du service de l'API Cloud KMS.
Cette page vous permet de consulter les détails des quotas de l'API Cloud KMS.
Pour demander une augmentation de quota pour un autre projet, sélectionnez le projet souhaité dans l' Trusted Cloud en-tête de la console.
Dans la liste des quotas, sélectionnez le quota par défaut ou régional que vous souhaitez augmenter, puis cliquez sur Modifier les quotas.
Dans le volet Modifications de quota, saisissez les limites souhaitées pour les quotas sélectionnés.
Dans Description de la demande, indiquez le motif de votre demande.
Cliquez sur Suivant pour continuer.
Indiquez vos coordonnées, y compris votre nom, votre adresse e-mail et votre numéro de téléphone.
Pour finaliser votre demande, cliquez sur Envoyer la requête.
Une fois votre demande envoyée, elle est transmise aux personnes chargées de l'examiner. Vous serez informé de l'état de votre demande une fois qu'elle aura été examinée.
Limiter l'utilisation de Cloud KMS pour un projet spécifique
Si vous souhaitez imposer un quota plus strict sur l'utilisation de vos ressources Cloud KMS, vous pouvez choisir de définir le quota d'un projet donné sur une limite inférieure à la valeur par défaut. Par exemple, si plusieurs projets dont les ressources utilisent des clés Cloud HSM ou Cloud EKM se trouvent dans le même projet, vous pouvez choisir de définir un quota inférieur pour les requêtes de chiffrement sur chaque projet appelant afin de vous assurer de ne pas dépasser un quota tel que les requêtes de chiffrement symétriques HSM par région sur le projet qui héberge ces clés.
Dans la Trusted Cloud console, accédez à la page Détails de l'API/du service de l'API Cloud KMS.
Cette page vous permet de consulter les détails des quotas de l'API Cloud KMS.
Pour réduire un quota pour un autre projet, sélectionnez le projet souhaité dans l' Trusted Cloud en-tête de la console.
Dans la liste des quotas, sélectionnez le quota par défaut ou régional que vous souhaitez réduire, puis cliquez sur Modifier les quotas.
Dans le volet Modifications de quota, saisissez les limites souhaitées pour les quotas sélectionnés.
Cliquez sur Suivant pour continuer.
Si vous réduisez un quota de plus de 10% de la limite actuelle, un avertissement s'affiche. Pour continuer à appliquer un quota inférieur au quota par défaut, cliquez sur Confirmer. Sinon, vous pouvez cliquer sur Annuler pour revenir en arrière et choisir une autre limite.
Pour enregistrer vos modifications, cliquez sur Envoyer la requête.
Pour en savoir plus sur la manière dont les bibliothèques clientes génèrent l'erreur RESOURCE_EXHAUSTED, consultez la section Mappage avec la bibliothèque cliente.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/18 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/18 (UTC)."],[],[],null,["# Monitor and adjust Cloud KMS quotas\n\nThis page shows you how to manage your Cloud Key Management Service quotas. For details on\nthe quotas associated with Cloud KMS, see [Quotas](/kms/quotas).\n\nBefore you begin\n----------------\n\nThe following permissions are required to view project quotas:\n\n- `resourcemanager.projects.get`\n- `monitoring.timeSeries.list`\n- `serviceusage.services.list`\n- `serviceusage.quotas.get`\n\nThe `serviceusage.quotas.update` permission is required to change project\nquotas.\n\nFor details about which IAM roles include these permissions, see\n[IAM permissions reference](/iam/docs/permissions-reference).\n\nCheck your Cloud KMS quotas\n---------------------------\n\n1. In the Google Cloud console, go to the **API/Service Details** page for the\n Cloud KMS API.\n\n [Go to Cloud KMS API/Service\n Details](https://console.cloud.google.com/apis/api/cloudkms.googleapis.com/quotas)\n\n This page lets you view quota details for the Cloud KMS API.\n2. To view quotas for a different project, select the desired project in the\n Google Cloud console header.\n\n3. To filter by quota type, click in the **Filter** bar and select **Quota**\n from the properties list, then choose the desired quota.\n\n4. To filter by region, click in the **Filter** bar and select **Dimensions\n (e.g. location):** from the properties list, then enter the desired region\n name.\n\nIf you find you are nearing or exceeding your quotas, you can\n[Request higher Cloud KMS quotas](#increase_quotas).\n\nTroubleshoot quota issues\n-------------------------\n\nIf Cloud KMS denies a request because the relevant quota's limit has\nbeen reached, it returns a `RESOURCE_EXHAUSTED` error. For requests made using\nthe Cloud KMS REST API, the `RESOURCE_EXHAUSTED` error has an HTTP\nstatus code of `429`. Because Cloud KMS hosting project\nquotas are enforced on a *per second* basis, occasional `RESOURCE_EXHAUSTED`\nerrors for HSM or EKM keys can be addressed by retrying the next second.\n\nRecurring `RESOURCE_EXHAUSTED` errors indicate that your project regularly\nexceeds one or more of its quotas. To address this issue, you can try any or all\nof the following:\n\n- Reduce the rate at which your projects are making requests that use\n Cloud KMS resources.\n\n- [Request higher Cloud KMS quotas](#increase_quotas).\n\n- Use separate projects for your resources where appropriate so that multiple\n resources aren't sharing the same quotas.\n\n - Calling project quotas - If you have a single project which contains\n several resources that use the Cloud KMS API at high request\n rates, consider moving resources to their own projects so that they do\n not share the 60,000 QPM limit.\n\n - Hosting project quotas - If you have a single project which contains\n Cloud HSM or Cloud EKM keys that support distinct\n resources with high QPS rates, consider splitting Cloud KMS\n keys into separate projects based on details like their priority or\n workload. This way fewer keys share the same Cloud HSM and\n Cloud EKM quotas.\n\n | **Note:** Creating additional projects as described here may create issues with other quotas, such as your **Projects per user** or **Projects per billing\n | account** quotas. For more information about Google Cloud quotas, see the [Cloud Quotas documentation](/docs/quotas/overview).\n- Add a backoff mechanism to your client to handle `RESOURCE_EXHAUSTED`\n errors.\n\nRequest higher Cloud KMS quotas\n-------------------------------\n\n1. In the Google Cloud console, go to the **API/Service Details** page for the\n Cloud KMS API.\n\n [Go to Cloud KMS API/Service\n Details](https://console.cloud.google.com/apis/api/cloudkms.googleapis.com/quotas)\n\n This page lets you view quota details for the Cloud KMS API.\n2. To request a quota increase for a different project, select the desired\n project in the Google Cloud console header.\n\n3. In the list of quotas, select the default or regional quota you wish to\n increase, then click **Edit Quotas**.\n\n | **Note:** Multiregional and global quotas do not appear in the console. To increase quota for multiregional locations or the global location, make the request for a different region and mention the multiregion in the **Request\n | description**.\n4. In the **Quota changes** pane, enter the desired limits for the selected\n quotas.\n\n5. In **Request description**, provide a description of the reason for your\n request.\n\n6. Click **Next** to continue.\n\n7. Provide your contact information including **Name** , **Email** , and\n **Phone**.\n\n8. To complete your request, click **Submit request**.\n\n Once your request is submitted, it is sent to approvers for evaluation. You\n will be notified about the status of your request once it has been reviewed.\n\nCap Cloud KMS usage for a specific project\n------------------------------------------\n\nIf you wish to impose a stricter quota on usage of your Cloud KMS\nresources, you can choose to set the quota for a given project to a lower limit\nthan the default. For example, if you have multiple projects whose resources use\nCloud HSM or Cloud EKM keys in the same project, you may\nchoose to set the **Cryptographic requests** quota lower on each calling\nproject to ensure that you do not go over a quota like\n**HSM symmetric cryptographic requests per region** on the project which hosts those keys.\n\n1. In the Google Cloud console, go to the **API/Service Details** page for the\n Cloud KMS API.\n\n [Go to Cloud KMS API/Service\n Details](https://console.cloud.google.com/apis/api/cloudkms.googleapis.com/quotas)\n\n This page lets you view quota details for the Cloud KMS API.\n2. To decrease a quota for a different project, select the desired project in\n the Google Cloud console header.\n\n3. In the list of quotas, select the default or regional quota you wish to\n decrease, then click **Edit Quotas**.\n\n4. In the **Quota changes** pane, enter the desired limits for the selected\n quotas.\n\n5. Click **Next** to continue.\n\n If you are reducing a quota by more than 10% of the current limit, a warning\n appears. To continue applying a lower quota than the default, click\n **Confirm** . Otherwise, you can click **Cancel** to go back and choose a new\n limit.\n6. To save your changes, click **Submit request**.\n\n Your new limit is active immediately.\n\nWhat's next\n-----------\n\n- Learn more about [Cloud Quotas](/docs/quotas/overview).\n- For information on how client libraries surface the `RESOURCE_EXHAUSTED` error, see [Client library mapping](/apis/design/errors#client_library_mapping).\n- View [details about Cloud KMS quotas](/kms/quotas)."]]
