All Products
Search
Document Center

Key Management Service:CreateKeyVersion

Last Updated:Jun 10, 2026

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

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 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.