全部产品
Search

搜索本产品

    ：Decrypt

    文档中心

    ：Decrypt

    更新时间：Dec 21, 2025

    Mendekripsi ciphertext.

    Deskripsi operasi

    Perhatian

    • 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 shared gateway atau dedicated gateway. Untuk informasi selengkapnya, lihat Alibaba Cloud SDK.

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

      • Dedicated gateway: Anda dapat mengakses KMS menggunakan private endpoint KMS (<YOUR_KMS_INSTANCE_ID>.cryptoservice.kms.aliyuncs.com).

    Batas QPS

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

    • Dedicated gateway: Batas QPS untuk satu pengguna pada operasi ini bergantung pada spesifikasi performa instans KMS Anda. Untuk informasi selengkapnya, lihat Metrik performa.

    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, serta memeriksa 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. 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.PendingDeletion The request was rejected because the key state is PendingDeletion. The request was rejected because the key state is PendingDeletion.
    409 Rejected.Unavailable The request was rejected because the key state is Unavailable. The request was denied because the key status is unavailable.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.