All Products
Search

This Product

    Key Management Service:GetManagedDataKey

    Document Center

    Key Management Service:GetManagedDataKey

    Last Updated:Jul 22, 2026

    Mengambil teks biasa dari kunci data (DK) terkelola.

    Deskripsi operasi

    Untuk informasi tentang kebijakan akses yang harus diberikan kepada Pengguna RAM atau Peran RAM untuk memanggil operasi ini, lihat Kontrol akses.

    Operasi ini dapat dipanggil melalui gerbang bersama. Untuk informasi lebih lanjut, lihat kit pengembangan perangkat lunak Alibaba Cloud.

    • Gerbang bersama: Akses KMS melalui endpoint publik atau VPC.

    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.

    Sintaks permintaan

    GET  HTTP/1.1

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    DataKeyName

    string

    No

    Nama kunci data (DK) terkelola. Parameter ini wajib diisi.

    example-data-key.
    DataKeyVersionId

    string

    No

    Nomor versi kunci data (DK) terkelola. Parameter ini opsional. Jika Anda menetapkan parameter ini ke nomor versi tertentu, teks biasa dari versi kunci data (DK) terkelola yang ditentukan akan dikembalikan.

    xH6OPUmz.
    UseLatest

    boolean

    No

    Apakah akan menggunakan versi terbaru dari kunci data (DK) terkelola ketika tidak ada nomor versi yang disediakan. Nilai valid:

    • true: Mengembalikan versi terbaru dari kunci data (DK) terkelola.

    • false: Mengembalikan versi pertama dari kunci data (DK) terkelola.

    Nilai default: false.

    true.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons.

    RequestId

    string

    ID permintaan. Alibaba Cloud menghasilkan pengidentifikasi unik untuk setiap permintaan. Anda dapat menggunakan ID permintaan untuk memecahkan masalah.

    4bd560a1-729e-45f1-a3d9-b2a33d61046b
    DataKeyName

    string

    Nama kunci data (DK) terkelola.

    example-data-key.
    DataKeyVersionName

    string

    Nama kredensial yang menyimpan bahan kunci dari versi kunci data (DK) terkelola yang dikembalikan.

    kms-datakeyversion!example-data-key!xH6OPUmz.
    DataKeyVersionId

    string

    Nomor versi dari kunci data (DK) terkelola yang dikembalikan.

    xH6OPUmz.
    Plaintext

    string

    Nilai teks biasa dengan pengkodean Base64 dari kunci data (DK).

    CYueyVmZJ2MfA1VSZV2jCbFT8bO7StAvBnHacplr9aI=

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "4bd560a1-729e-45f1-a3d9-b2a33d61046b",
  "DataKeyName": "example-data-key",
  "DataKeyVersionName": "kms-datakeyversion!example-data-key!xH6OPUmz",
  "DataKeyVersionId": "xH6OPUmz\n",
  "Plaintext": "CYueyVmZJ2MfA1VSZV2jCbFT8bO7StAvBnHacplr9aI="
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.