En esta página, se muestra cómo administrar tus cuotas de Cloud Key Management Service. Para obtener detalles sobre las cuotas asociadas con Cloud KMS, consulta Cuotas.
Antes de comenzar
Se requieren los siguientes permisos para ver las cuotas de proyecto:
resourcemanager.projects.get
monitoring.timeSeries.list
serviceusage.services.list
serviceusage.quotas.get
Se requiere el permiso serviceusage.quotas.update para cambiar las cuotas del proyecto.
Para obtener más información sobre qué roles de IAM incluyen estos permisos, consulta Referencia de permisos de IAM.
Verifica tus cuotas de Cloud KMS
En la Trusted Cloud consola, ve a la página Detalles de la API o el servicio de la API de Cloud KMS.
En esta página, puedes ver los detalles de las cuotas de la API de Cloud KMS.
Para ver las cuotas de otro proyecto, selecciona el proyecto deseado en el encabezado de la consolaTrusted Cloud .
Para filtrar por tipo de cuota, haz clic en la barra Filtro, selecciona Cuota en la lista de propiedades y, luego, elige la cuota deseada.
Para filtrar por región, haz clic en la barra Filtro y selecciona Dimensiones (p.ej., ubicación): en la lista de propiedades y, luego, ingresa el nombre de la región que desees.
Si Cloud KMS rechaza una solicitud porque se alcanzó el límite de la cuota relevante, muestra un error RESOURCE_EXHAUSTED. En el caso de las solicitudes realizadas con la API de REST de Cloud KMS, el error RESOURCE_EXHAUSTED tiene un código de estado HTTP de 429. Debido a que las cuotas del proyecto de hosting de Cloud KMS se aplican por segundo, los errores ocasionales de RESOURCE_EXHAUSTED para las claves de HSM o EKM se pueden abordar volviendo a intentarlo al segundo siguiente.
Los errores RESOURCE_EXHAUSTED recurrentes indican que tu proyecto supera con frecuencia una o más de sus cuotas. Para solucionar este problema, puedes probar una o todas las siguientes opciones:
Reduce la velocidad a la que tus proyectos realizan solicitudes que usan recursos de Cloud KMS.
Usa proyectos separados para tus recursos cuando corresponda, de modo que varios recursos no compartan las mismas cuotas.
Cuotas de llamadas de proyectos: Si tienes un solo proyecto que contiene varios recursos que usan la API de Cloud KMS a tasas de solicitudes altas, considera mover los recursos a sus propios proyectos para que no compartan el límite de 60,000 QPM.
Cuotas de proyectos de alojamiento: Si tienes un solo proyecto que contiene claves de Cloud HSM o Cloud EKM que admiten recursos distintos con tasas de QPS altas, considera dividir las claves de Cloud KMS en proyectos independientes según detalles como su prioridad o carga de trabajo. De esta manera, menos claves comparten las mismas cuotas de Cloud HSM y
Cloud EKM.
Agrega un mecanismo de retirada a tu cliente para controlar los errores de RESOURCE_EXHAUSTED.
Solicita cuotas más altas de Cloud KMS
En la Trusted Cloud consola, ve a la página Detalles de la API o el servicio de la API de Cloud KMS.
En esta página, puedes ver los detalles de las cuotas de la API de Cloud KMS.
Para solicitar un aumento de cuota para un proyecto diferente, selecciona el proyecto deseado en el encabezado de la Trusted Cloud consola.
En la lista de cuotas, selecciona la cuota regional o predeterminada que deseas
aumentar y, luego, haz clic en Editar cuotas.
En el panel Cambios de cuota, ingresa los límites deseados para las cuotas seleccionadas.
En Descripción de la solicitud, proporciona una descripción del motivo de la solicitud.
Haz clic en Siguiente para continuar.
Proporciona tu información de contacto, como Nombre, Correo electrónico y Teléfono.
Para completar la solicitud, haz clic en Enviar solicitud.
Una vez que se envía la solicitud, se envía a los revisores para su evaluación. Se te notificará el estado de tu solicitud una vez que se haya revisado.
Limita el uso de Cloud KMS para un proyecto específico
Si deseas imponer una cuota más estricta en el uso de tus recursos de Cloud KMS, puedes establecer la cuota de un proyecto determinado en un límite inferior al predeterminado. Por ejemplo, si tienes varios proyectos cuyos recursos usan claves de Cloud HSM o Cloud EKM en el mismo proyecto, puedes establecer una cuota más baja de solicitudes criptográficas en cada proyecto de llamada para asegurarte de no superar una cuota como solicitudes criptográficas simétricas de HSM por región en el proyecto que aloja esas claves.
En la Trusted Cloud consola, ve a la página Detalles de la API o el servicio de la API de Cloud KMS.
En esta página, puedes ver los detalles de las cuotas de la API de Cloud KMS.
Para disminuir una cuota de un proyecto diferente, selecciona el proyecto deseado en el encabezado de la consola de Trusted Cloud .
En la lista de cuotas, selecciona la cuota predeterminada o regional que deseas disminuir y, luego, haz clic en Editar cuotas.
En el panel Cambios de cuota, ingresa los límites deseados para las cuotas seleccionadas.
Haz clic en Siguiente para continuar.
Si reduces una cuota en más del 10% del límite actual, aparecerá una advertencia. Para seguir aplicando una cuota inferior a la predeterminada, haz clic en Confirmar. De lo contrario, puedes hacer clic en Cancelar para volver y elegir un límite nuevo.
Para guardar los cambios, haz clic en Enviar solicitud.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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)."]]
