全部产品
Search

搜索本产品

    ：Decrypt

    文档中心

    ：Decrypt

    更新时间：Feb 05, 2026

    Mendekripsi ciphertext.

    Deskripsi operasi

    Persiapan

    • Untuk informasi mengenai kebijakan akses yang diperlukan agar Pengguna RAM atau Peran RAM dapat memanggil operasi ini, lihat Resource Access Management.

    • Anda dapat memanggil operasi ini melalui gateway bersama atau gateway khusus. Untuk informasi selengkapnya, lihat Alibaba Cloud SDK.

      • Gateway bersama: Anda dapat mengakses KMS melalui Internet atau menggunakan nama domain VPC. Untuk menggunakan gateway bersama, Anda harus mengaktifkan akses Internet. Untuk informasi selengkapnya, lihat Mengakses kunci dalam instans KMS melalui Internet.

      • Gateway khusus: Anda dapat mengakses KMS menggunakan titik akhir pribadi KMS (<YOUR_KMS_INSTANCE_ID>.cryptoservice.kms.aliyuncs.com).

    Batas QPS

    • Gateway bersama: Batas queries per second (QPS) untuk satu pengguna pada operasi ini adalah 1.000. Jika batas ini dilampaui, panggilan API akan dikenai pengendalian aliran, yang dapat memengaruhi bisnis Anda. Kami menyarankan agar Anda merencanakan panggilan API secara sesuai.

    • Gateway khusus: Batas QPS untuk satu pengguna pada operasi ini bergantung pada spesifikasi kinerja instans KMS Anda. Untuk informasi selengkapnya, lihat Metrik kinerja.

    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
    CiphertextBlob

    string

    Yes

    Ciphertext yang ingin Anda dekripsi.
    Ciphertext ini dihasilkan dengan memanggil operasi API berikut:

    DZhOWVmZDktM2QxNi00ODk0LWJkNGYtMWZjNDNmM2YyYWJmaaSl+TztSIMe43nbTH/Z1Wr4XfLftKhAciUmDQXuMRl4WTvKhxjMThjK****
    EncryptionContext

    object

    No

    String JSON yang terdiri dari pasangan kunci-nilai.

    Catatan

    Jika Anda menentukan EncryptionContext saat memanggil operasi GenerateDataKey, Encrypt, atau GenerateDataKeyWithoutPlaintext untuk mengenkripsi data, Anda harus menentukan parameter yang sama saat mendekripsi. Untuk informasi selengkapnya, lihat EncryptionContext.

    {"Example":"Example"}
    DryRun

    string

    No

    Menentukan apakah fitur dry run diaktifkan.

    • true: mengaktifkan fitur dry run.

    • false (default): menonaktifkan fitur dry run.

    Fitur dry run memungkinkan Anda menguji panggilan API, memeriksa apakah Anda memiliki izin yang diperlukan pada resource, dan memverifikasi validitas parameter permintaan. Jika Anda mengaktifkan fitur dry run, KMS selalu mengembalikan respons kegagalan yang menunjukkan penyebab kegagalan tersebut. Penyebab yang mungkin terjadi antara lain:

    • DryRunOperationError: Permintaan akan berhasil jika parameter DryRun tidak ditentukan.

    • ValidationError: Parameter yang ditentukan dalam permintaan tidak valid.

    • AccessDeniedError: Anda tidak memiliki otorisasi untuk melakukan operasi ini pada resource KMS.

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    KeyVersionId

    string

    ID versi kunci yang digunakan untuk mendekripsi ciphertext. Versi kunci ini merupakan versi dari master key.

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

    string

    ID master key yang digunakan untuk mendekripsi ciphertext.
    Identifier unik global dari master key tersebut.

    202b9877-5a25-46e3-a763-e20791b5****
    RequestId

    string

    ID permintaan. ID ini merupakan identifier unik global yang dihasilkan oleh Alibaba Cloud untuk permintaan tersebut. Anda dapat menggunakan ID ini untuk pemecahan masalah.

    207596a2-36d3-4840-b1bd-f87044699bd7
    Plaintext

    string

    Teks biasa hasil dekripsi.

    tRYXuCwgja12xxO1N/gZERDDCLw9doZEQiPDk/Bv****

    Contoh

    Respons sukses

    JSONformat

    {
  "KeyVersionId": "2ab1a983-7072-4bbc-a582-584b5bd8****",
  "KeyId": "202b9877-5a25-46e3-a763-e20791b5****",
  "RequestId": "207596a2-36d3-4840-b1bd-f87044699bd7",
  "Plaintext": "tRYXuCwgja12xxO1N/gZERDDCLw9doZEQiPDk/Bv****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 UnsupportedOperation This action is not supported.
    404 Forbidden.AliasNotFound The specified Alias is not found.
    404 Forbidden.KeyNotFound The specified Key is not found.
    409 Rejected.Disabled The request was rejected because the key state is Disabled.
    409 Rejected.PendingDeletion The request was rejected because the key state is PendingDeletion.
    409 Rejected.Unavailable The request was rejected because the key state is Unavailable.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.