Untuk memanggil operasi API dari Key Management Service (KMS), Anda harus mengirimkan permintaan HTTPS GET atau HTTPS POST ke titik akhir KMS. Tambahkan parameter permintaan saat memanggil operasi API. Setelah pemanggilan, sistem akan mengembalikan respons. Permintaan dan respons dienkripsi dalam format UTF-8.
Sintaksis Permintaan
Operasi API KMS menggunakan protokol RPC. Anda dapat memanggil operasi API dengan mengirimkan permintaan HTTPS GET atau HTTPS POST.
Berikut adalah sintaksis permintaan yang digunakan:
https://Endpoint/?Action=xx&Version=xx&ParametersTabel berikut menjelaskan parameter dalam sintaksis permintaan.
Parameter | Deskripsi |
Endpoint | Titik akhir KMS. Untuk informasi lebih lanjut, lihat Titik Akhir. |
Action | Nama operasi yang ingin Anda panggil. Sebagai contoh, untuk membuat kunci, Anda harus mengatur Action menjadi CreateKey. |
Version | Versi API. Versi API KMS adalah 2016-01-20. |
Parameters | Parameter permintaan. Pisahkan beberapa parameter permintaan dengan tanda ampersand (&). Parameter permintaan mencakup parameter umum dan parameter spesifik operasi. Parameter umum mencakup nomor versi API dan informasi autentikasi. Untuk informasi lebih lanjut, lihat Parameter Umum. |
Contoh Permintaan
Dalam contoh berikut, operasi CreateKey dipanggil untuk membuat kunci.
Contoh permintaan diformat untuk meningkatkan keterbacaan.
https://kms.cn-hangzhou.aliyuncs.com/?Action=CreateKey
&Format=json
&Version=2016-01-20
&AccessKeyId=te****
&Signature=YlrFhyqDZQ1ThNYARrv3Ptaxqf****
&SignatureMethod=HMAC-SHA1
&Timestamp=2016-03-25T09:36:58Z
&SignatureVersion=1.0
…Titik Akhir
Protokol
Anda harus memanggil operasi API KMS dengan mengirimkan permintaan HTTPS.
KMS hanya mendukung Transport Layer Security (TLS) versi 1.0 dan yang lebih baru. KMS tidak mendukung SSL 2.0 atau SSL 3.0.