All Products
Search

This Product

    Key Management Service:DescribeKeyVersion

    Document Center

    Key Management Service:DescribeKeyVersion

    Last Updated:Jun 10, 2026

    Meminta metadata dari versi CMK tertentu.

    Deskripsi operasi

    Topik ini memberikan contoh tentang cara meminta informasi tentang versi CMK 1234abcd-12ab-34cd-56ef-12345678****. ID versi CMK adalah 2ab1a983-7072-4bbc-a582-584b5bd8****. Respons menunjukkan bahwa waktu pembuatan versi CMK adalah 2016-03-25T10:42:40Z.

    Untuk informasi selengkapnya 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 unik global dari CMK.

    Anda juga dapat mengatur parameter ini ke alias yang terikat pada CMK. Untuk informasi selengkapnya, lihat Ikhtisar alias.

    1234abcd-12ab-34cd-56ef-12345678****
    KeyVersionId

    string

    Yes

    ID unik global dari versi CMK.

    Anda dapat memanggil operasi ListKeyVersions untuk meminta versi CMK.

    2ab1a983-7072-4bbc-a582-584b5bd8****

    Untuk informasi selengkapnya tentang parameter permintaan umum, lihat Parameter umum.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    7021b6ec-4be7-4d3c-8a68-1e85d4d515a0
    KeyVersion

    object

    Metadata dari versi CMK.

    KeyId

    string

    ID unik global dari CMK.

    Catatan

    Jika Anda mengatur parameter KeyId dalam permintaan ke alias dari CMK, ID dari CMK yang terikat dengan alias tersebut akan dikembalikan.

    1234abcd-12ab-34cd-56ef-12345678****
    KeyVersionId

    string

    ID unik global dari versi CMK.

    2ab1a983-7072-4bbc-a582-584b5bd8****
    CreationDate

    string

    Tanggal dan waktu saat versi CMK dibuat. Waktu ditampilkan dalam UTC.

    2016-03-25T10:42:40Z

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "7021b6ec-4be7-4d3c-8a68-1e85d4d515a0",
  "KeyVersion": {
    "KeyId": "1234abcd-12ab-34cd-56ef-12345678****",
    "KeyVersionId": "2ab1a983-7072-4bbc-a582-584b5bd8****",
    "CreationDate": "2016-03-25T10:42:40Z"
  }
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParameter The specified parameter is not valid. An invalid value is specified for the parameter.
    404 InvalidAccessKeyId.NotFound The Access Key ID provided does not exist in our records.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.