Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Halaman ini menunjukkan cara mengelola kuota Cloud Key Management Service. Untuk mengetahui detail tentang kuota yang terkait dengan Cloud KMS, lihat Kuota.
Sebelum memulai
Izin berikut diperlukan untuk melihat kuota project:
resourcemanager.projects.get
monitoring.timeSeries.list
serviceusage.services.list
serviceusage.quotas.get
Izin serviceusage.quotas.update diperlukan untuk mengubah kuota project.
Untuk mengetahui detail tentang peran IAM yang menyertakan izin ini, lihat
referensi izin IAM.
Memeriksa kuota Cloud KMS
Di konsol Google Cloud , buka halaman API/Service Details untuk Cloud KMS API.
Halaman ini memungkinkan Anda melihat detail kuota untuk Cloud KMS API.
Untuk melihat kuota project lain, pilih project yang diinginkan di header konsolGoogle Cloud .
Untuk memfilter menurut jenis kuota, klik panel Filter, lalu pilih Kuota
dari daftar properti, lalu pilih kuota yang diinginkan.
Untuk memfilter menurut wilayah, klik panel Filter, lalu pilih Dimensi
(mis. lokasi): dari daftar properti, lalu masukkan nama wilayah
yang diinginkan.
Jika Cloud KMS menolak permintaan karena batas kuota yang relevan telah tercapai, Cloud KMS akan menampilkan error RESOURCE_EXHAUSTED. Untuk permintaan yang dibuat menggunakan Cloud KMS REST API, error RESOURCE_EXHAUSTED memiliki kode status HTTP 429. Karena kuota project hosting Cloud KMS diterapkan berdasarkan per detik, error RESOURCE_EXHAUSTED
terkadang untuk kunci HSM atau EKM dapat diatasi dengan mencoba lagi di detik berikutnya.
Error RESOURCE_EXHAUSTED berulang menunjukkan bahwa project Anda secara rutin melebihi satu atau beberapa kuotanya. Untuk mengatasi masalah ini, Anda dapat mencoba salah satu atau semua
hal berikut:
Kurangi frekuensi project Anda membuat permintaan yang menggunakan
resource Cloud KMS.
Gunakan project terpisah untuk resource Anda jika sesuai sehingga beberapa resource tidak berbagi kuota yang sama.
Memanggil kuota project - Jika Anda memiliki satu project yang berisi beberapa resource yang menggunakan Cloud KMS API dengan frekuensi permintaan tinggi, pertimbangkan untuk memindahkan resource ke project-nya sendiri sehingga tidak berbagi batas 60.000 QPM.
Kuota project hosting - Jika Anda memiliki satu project yang berisi kunci Cloud HSM atau Cloud EKM yang mendukung resource berbeda dengan rasio QPS tinggi, pertimbangkan untuk memisahkan kunci Cloud KMS ke dalam project terpisah berdasarkan detail seperti prioritas atau workload-nya. Dengan cara ini, lebih sedikit kunci yang menggunakan kuota Cloud HSM dan Cloud EKM yang sama.
Tambahkan mekanisme backoff ke klien Anda untuk menangani error RESOURCE_EXHAUSTED.
Meminta kuota Cloud KMS yang lebih tinggi
Di konsol Google Cloud , buka halaman API/Service Details untuk Cloud KMS API.
Halaman ini memungkinkan Anda melihat detail kuota untuk Cloud KMS API.
Untuk meminta penambahan kuota untuk project lain, pilih project yang diinginkan di header konsol Google Cloud .
Dalam daftar kuota, pilih kuota default atau regional yang ingin Anda
tingkatkan, lalu klik Edit Quotas.
Di panel Quota changes, masukkan batas yang diinginkan untuk kuota
yang dipilih.
Di Deskripsi permintaan, berikan deskripsi alasan permintaan Anda.
Klik Next untuk melanjutkan.
Berikan informasi kontak Anda, termasuk Nama, Email, dan
Telepon.
Untuk menyelesaikan permintaan Anda, klik Kirim permintaan.
Setelah dikirim, permintaan Anda akan dikirim ke pemberi persetujuan untuk dievaluasi. Anda
akan diberi tahu tentang status permintaan Anda setelah ditinjau.
Membatasi penggunaan Cloud KMS untuk project tertentu
Jika ingin menerapkan kuota yang lebih ketat pada penggunaan resource Cloud KMS, Anda dapat memilih untuk menetapkan kuota untuk project tertentu ke batas yang lebih rendah daripada default. Misalnya, jika Anda memiliki beberapa project yang resource-nya menggunakan
kunci Cloud HSM atau Cloud EKM dalam project yang sama, Anda dapat
memilih untuk menetapkan kuota Permintaan kriptografis yang lebih rendah di setiap project
pemanggil untuk memastikan bahwa Anda tidak melebihi kuota seperti
Permintaan kriptografis simetris HSM per region
pada project yang menghosting kunci tersebut.
Di konsol Google Cloud , buka halaman API/Service Details untuk Cloud KMS API.
Halaman ini memungkinkan Anda melihat detail kuota untuk Cloud KMS API.
Untuk mengurangi kuota project lain, pilih project yang diinginkan di
header konsol Google Cloud .
Dalam daftar kuota, pilih kuota default atau regional yang ingin Anda kurangi, lalu klik Edit Quotas.
Di panel Quota changes, masukkan batas yang diinginkan untuk kuota
yang dipilih.
Klik Next untuk melanjutkan.
Jika Anda mengurangi kuota lebih dari 10% dari batas saat ini, peringatan akan muncul. Untuk melanjutkan penerapan kuota yang lebih rendah dari default, klik
Konfirmasi. Jika tidak, Anda dapat mengklik Batal untuk kembali dan memilih batas baru.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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)."]]
