Cloud Key Management Service memiliki antarmuka REST/HTTP dan gRPC tradisional. Jika tidak ingin menggunakan library klien kami untuk mengakses Cloud Key Management Service API, Anda dapat menulis library klien sendiri yang menggunakan platform REST/HTTP atau gRPC API-nya. Kami merekomendasikan pendekatan ini hanya jika bahasa pemrograman Anda atau kebutuhan lainnya tidak terpenuhi oleh library klien yang disediakan.
API gRPC
Anda dapat membuat library klien gRPC sendiri dalam bahasa yang didukung gRPC untuk Cloud Key Management Service API dari definisi layanan .proto-nya menggunakan resource berikut:
- Menggunakan gRPC dengan Cloud KMS
- Definisi layanan Cloud KMS
- Dokumentasi gRPC: Semua yang Anda perlukan untuk membuat dan menggunakan kode klien gRPC Anda sendiri.
- Referensi RPC API: Ringkasan platform RPC yang tidak bergantung bahasa.
API REST/HTTP
Ada sejumlah opsi untuk berinteraksi dengan antarmuka REST layanan. Untuk membuat klien Anda sendiri, gunakan referensi berikut:
- Referensi REST API
- Panduan menggunakan Google HTTP API
- Layanan Penemuan API: Mengekspos metadata yang dapat dibaca mesin tentang platform REST/HTTP API, yang berguna untuk membuat library klien, alat, dan plugin.
- Direktori contoh klien yang dibuat dengan REST/HTTP API dan Google API Discovery Service.
Endpoint Layanan
Cloud KMS memiliki endpoint layanan global dan regional. Endpoint REST/HTTP global adalah https://cloudkms.googleapis.com
dan endpoint gRPC global adalah cloudkms.googleapis.com
. Endpoint global merutekan permintaan ke layanan regional di lokasi yang ditentukan oleh nama resource.
Endpoint REST/HTTP regional adalah https://<region>-cloudkms.googleapis.com
dan endpoint gRPC regional adalah <region>-cloudkms.googleapis.com
, yang menggantikan <region>
untuk salah satu lokasi Cloud KMS regional, dual-regional, atau multi-regional yang didukung. Endpoint ini diisolasi berdasarkan lokasi, yang berarti setiap endpoint akan merutekan permintaan ke layanan regional di lokasi yang ditentukan oleh nama endpoint. Jika lokasi yang ditentukan oleh
nama resource tidak cocok dengan lokasi yang ditentukan oleh endpoint, permintaan
akan gagal.