Jika menggunakan library gRPC yang dibuat secara manual untuk melakukan panggilan ke Cloud Key Management Service, Anda harus menentukan nilai x-google-request-params
dalam metadata, atau header, panggilan. Penggunaan x-google-request-params
yang tepat akan mengarahkan panggilan ke region yang sesuai untuk resource Cloud KMS Anda.
Tetapkan nilai x-google-request-params
ke kolom dalam permintaan metode seperti
yang ditunjukkan dalam tabel berikut.
Menetapkan kolom permintaan
Contoh berikut menunjukkan tempat untuk menetapkan nama resource dalam berbagai metode. Ganti teks yang diberi gaya sebagai place-holder dengan nilai sebenarnya yang digunakan dalam ID resource Cloud KMS Anda.
Contoh dekripsi
Jika melakukan panggilan untuk Mendekripsi, Anda harus mengisi kolom berikut dalam permintaan:
name: 'projects/project-id/locations/location/keyRings/key-ring/cryptoKeys/key-name/' ciphertext: 'iQALWM/r6alAxQm0VQe3...'
Nilai yang ditetapkan ke kolom name
adalah nama resource Bigtable Anda.
Untuk merutekan panggilan dengan benar, Anda juga harus menyertakan nama resource ini dalam
metadata panggilan, dalam bentuk berikut:
x-goog-request-params: 'name=projects/project-id/locations/location/keyRings/key-ring/cryptoKeys/key-name/'
Contoh CreateKeyRing
Jika melakukan panggilan ke CreateKeyRing, Anda harus mengisi kolom berikut dalam permintaan:
parent: 'projects/project-id/locations/location/' key_ring_id: 'myKeyRing' ...
Metadata panggilan juga harus berisi nama resource parent
:
x-goog-request-params: 'parent=projects/project-id/locations/location/'
Contoh UpdateCryptoKey
Jika melakukan panggilan ke UpdateCryptoKey, Anda harus mengisi kolom berikut dalam permintaan:
name: 'projects/project-id/locations/location/keyRings/key-ring/cryptoKeys/key-name/' field_mask: ...
Metadata tersebut juga harus berisi nama resource name
. Perhatikan bahwa format
menggunakan crypto_key.name=
, bukan name=
:
x-goog-request-params: 'crypto_key.name=projects/project-id/locations/location/keyRings/key-ring/cryptoKeys/key-name/'
Menambahkan metadata menggunakan C++
Jika Anda menggunakan C++, panggil ClientContext::AddMetadata
sebelum melakukan panggilan RPC untuk menambahkan informasi yang sesuai ke metadata panggilan.
Misalnya, jika Anda menambahkan metadata untuk panggilan ke Dekripsi:
context.AddMetadata("x-goog-request-params", "name=projects/project-id/locations/location/keyRings/key-ring-name/cryptoKeys/key-name/");
Selanjutnya, Anda dapat meneruskan konteks ke panggilan metode seperti biasa, beserta buffering protokol respons dan permintaan Anda.