Membuat versi baru untuk kunci master pelanggan (CMK).
Deskripsi operasi
Anda hanya dapat membuat versi untuk CMK asimetris yang berstatus Enabled. Untuk membuat CMK asimetris, panggil operasi CreateKey, dan gunakan operasi DescribeKey untuk memeriksa status CMK tersebut. Status ditentukan oleh parameter KeyState.
Interval minimum antara pembuatan versi untuk CMK yang sama adalah tujuh hari. Anda dapat menggunakan operasi DescribeKey untuk mengetahui waktu pembuatan versi terakhir CMK, yang ditentukan oleh parameter LastRotationDate.
Jika CMK berada di private key store, Anda tidak dapat membuat versi untuk CMK tersebut.
Anda dapat membuat maksimal 50 versi untuk satu CMK dalam satu Wilayah.
Anda dapat membuat versi untuk CMK dengan ID 0b30658a-ed1a-4922-b8f7-a673ca9c**** menggunakan parameter yang dijelaskan dalam topik ini.
Coba sekarang
Test
RAM authorization
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| KeyId |
string |
Yes |
ID CMK. ID tersebut harus unik secara global. Catatan
Anda juga dapat mengatur nilainya ke alias yang terikat pada CMK tersebut. Untuk informasi selengkapnya, lihat Overview of aliases. |
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 tersebut. |
|
| KeyId |
string |
ID CMK. ID tersebut harus unik secara global. |
0b30658a-ed1a-4922-b8f7-a673ca9c**** |
| KeyVersionId |
string |
ID versi tersebut. |
c0a3d5dc-0b47-4199-a050-b289349a**** |
| CreationDate |
string |
Tanggal dan waktu pembuatan versi tersebut. 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.