Membuat versi untuk customer master key (CMK).
Deskripsi operasi
-
Anda hanya dapat membuat versi untuk CMK asimetris yang berada dalam status Enabled. Anda dapat memanggil operasi CreateKey untuk membuat CMK asimetris dan operasi DescribeKey untuk mengkueri status CMK. Status ditentukan oleh parameter KeyState.
-
Interval minimum untuk membuat versi dari CMK yang sama adalah tujuh hari. Anda dapat memanggil operasi DescribeKey untuk mengkueri waktu saat versi terakhir CMK dibuat. Waktu ditentukan oleh parameter LastRotationDate.
-
Jika CMK berada di private key store, Anda tidak dapat membuat versi untuk CMK tersebut.
-
Anda dapat membuat maksimum 50 versi untuk CMK di region yang sama.
Anda dapat membuat versi untuk CMK yang ID-nya 0b30658a-ed1a-4922-b8f7-a673ca9c**** dengan menggunakan pengaturan parameter yang disediakan dalam topik ini.
Untuk informasi lebih lanjut tentang kebijakan akses yang diperlukan oleh pengguna RAM atau peran RAM untuk memanggil API ini, lihat Resource Access Management.
Coba sekarang
Test
RAM authorization
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| KeyId |
string |
Yes |
ID dari CMK. ID harus unik secara global. Catatan
Anda juga dapat menetapkan nilai ke alias yang terikat dengan CMK. Untuk informasi lebih lanjut, lihat Ikhtisar alias. |
0b30658a-ed1a-4922-b8f7-a673ca9c**** |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
|||
| RequestId |
string |
ID permintaan. |
b96f250a-4b75-498c-91be-22c6928f85be |
| KeyVersion |
object |
Metadata versi. |
|
| KeyId |
string |
ID dari CMK. ID harus unik secara global. |
0b30658a-ed1a-4922-b8f7-a673ca9c**** |
| KeyVersionId |
string |
ID versi. |
c0a3d5dc-0b47-4199-a050-b289349a**** |
| CreationDate |
string |
Tanggal dan waktu saat versi dibuat. Waktu ditampilkan dalam UTC. |
2019-08-02T10:38:27Z |
Contoh
Respons sukses
JSONformat
{
"RequestId": "b96f250a-4b75-498c-91be-22c6928f85be",
"KeyVersion": {
"KeyId": "0b30658a-ed1a-4922-b8f7-a673ca9c****",
"KeyVersionId": "c0a3d5dc-0b47-4199-a050-b289349a****",
"CreationDate": "2019-08-02T10:38:27Z"
}
}
Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | Rejected.UnsupportedOperation | Unsupported operation. | The operation is not supported. |
| 404 | Forbidden.AliasNotFound | The specified Alias is not found. | The error message returned because the specified alias does not exist. |
| 404 | Forbidden.KeyNotFound | The specified Key is not found. | The error message returned because the specified CMK does not exist. |
| 409 | Rejected.Disabled | The request was rejected because the key state is Disabled. | The request was rejected because the key state is Disabled. |
| 409 | Rejected.Unavailable | The request was rejected because the key state is Unavailable. | The request was denied because the key status is unavailable. |
| 409 | Rejected.PendingDeletion | The request was rejected because the key state is PendingDeletion. | The request was rejected because the key state is PendingDeletion. |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.