UpdateRotationPolicy - Key Management Service

Deskripsi operasi

Ketika rotasi kunci otomatis diaktifkan, KMS secara otomatis membuat versi kunci baru setelah periode rotasi yang ditentukan berakhir, lalu menetapkan versi tersebut sebagai versi kunci primary.

Kebijakan rotasi kunci otomatis tidak dapat dikonfigurasi untuk kunci-kunci berikut:

Asymmetric key
Service-managed key
Bring your own key (BYOK) yang diimpor ke KMS
Kunci yang tidak berada dalam status Enabled

Pada contoh ini, rotasi kunci otomatis diaktifkan untuk CMK dengan ID 1234abcd-12ab-34cd-56ef-12345678**** dan periode rotasi otomatisnya adalah 30 hari.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter	Type	Required	Description	Example
KeyId	string	Yes	ID dari customer master key (CMK). ID tersebut harus bersifat unik secara global.	1234abcd-12ab-34cd-56ef-12345678****
EnableAutomaticRotation	boolean	Yes	Menentukan apakah akan mengaktifkan rotasi kunci otomatis. Nilai yang valid: true: mengaktifkan rotasi kunci otomatis. false: menonaktifkan rotasi kunci otomatis.	true
RotationInterval	string	No	Periode rotasi kunci otomatis. Tentukan nilai dalam format integer[unit]. Unit yang didukung meliputi: d (hari), h (jam), m (menit), dan s (detik). Misalnya, Anda dapat menggunakan 7d atau 604800s untuk menentukan periode tujuh hari. Periode tersebut dapat berkisar antara 7 hari hingga 730 hari. Catatan Jika Anda menetapkan parameter EnableAutomaticRotation ke true, Anda juga harus menentukan parameter ini. Jika Anda menetapkan EnableAutomaticRotation ke false, Anda dapat tidak menentukan parameter ini.	30d

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan, yang digunakan untuk melacak dan memecahkan masalah.	efb1cbbd-a093-4278-bc03-639dd4fcc207

Contoh

Respons sukses

JSONformat

{
  "RequestId": "efb1cbbd-a093-4278-bc03-639dd4fcc207"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	Rejected.UnsupportedOperation	Unsupported operation.	The operation is not supported.
400	InvalidParameter	The specified parameter RotationInterval is not valid.	Invalid RotationInterval parameter value.
404	Forbidden.KeyNotFound	The specified Key is not found.	The error message returned because the specified CMK does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.