Cloud Key Management Service memiliki antarmuka REST/HTTP tradisional dan gRPC. Jika tidak ingin menggunakan library klien kami untuk mengakses Cloud Key Management Service API, Anda memiliki opsi untuk menulis library klien Anda sendiri yang menggunakan platform REST/HTTP atau gRPC API-nya. Sebaiknya gunakan pendekatan ini hanya jika bahasa pemrograman atau kebutuhan lainnya tidak terpenuhi oleh library klien yang disediakan.
gRPC API
Anda dapat membuat library klien gRPC Anda sendiri dalam bahasa apa pun yang didukung gRPC untuk Cloud Key Management Service API dari definisi layanan .proto-nya menggunakan referensi berikut:
- Menggunakan gRPC dengan Cloud KMS
- Definisi layanan Cloud KMS
- Dokumentasi gRPC: Semua yang Anda perlu untuk membuat dan menggunakan kode klien gRPC Anda sendiri.
- Referensi RPC API: Ringkasan RPC yang tidak bergantung pada bahasa.
REST/HTTP API
Ada sejumlah opsi untuk berinteraksi dengan antarmuka REST layanan. Untuk membuat klien Anda sendiri, gunakan referensi berikut:
- Referensi REST API
- Panduan untuk 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 Layanan Penemuan Google API.
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 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.