全部产品
Search
文档中心

Key Management Service:CreateKeyVersion

更新时间:Dec 21, 2025

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

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