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 dapat menulis library klien sendiri yang menggunakan 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 perlukan untuk membuat dan menggunakan kode klien gRPC Anda sendiri.
- Referensi RPC API: Ringkasan antarmuka RPC yang tidak bergantung pada bahasa.
REST/HTTP API
Ada sejumlah opsi untuk berinteraksi dengan REST API 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 REST/HTTP API surface, 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 per lokasi. Endpoint REST/HTTP global adalah https://cloudkms.googleapis.com dan endpoint gRPC global adalah cloudkms.googleapis.com. Endpoint global merutekan permintaan ke layanan lokasi di lokasi yang ditentukan oleh nama resource.
Endpoint REST/HTTP lokasi adalah
https://<region>-cloudkms.googleapis.com dan
endpoint gRPC lokasi adalah
<region>-cloudkms.googleapis.com, dengan mengganti
<region> untuk salah satu lokasi Cloud KMS regional, region ganda, atau multiregional yang didukung. Endpoint ini diisolasi berdasarkan
lokasi, yang berarti setiap endpoint merutekan permintaan ke layanan lokasi 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.