All Products
Search

This Product

    Key Management Service:GetPublicKey

    Document Center

    Key Management Service:GetPublicKey

    Last Updated:Dec 21, 2025

    Mengambil kunci publik dari kunci asimetris. Anda dapat menggunakan kunci publik tersebut untuk mengenkripsi data atau memverifikasi signature pada perangkat Anda.

    Deskripsi operasi

    • Untuk informasi selengkapnya mengenai kebijakan akses yang diperlukan agar pengguna RAM atau role RAM dapat memanggil operasi OpenAPI 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. Jika mengakses KMS melalui Internet, Anda harus mengaktifkan akses Internet. Untuk informasi selengkapnya, lihat Access keys in a KMS instance over the Internet.

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

    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

    Identifier unik global dari customer master key (CMK). Parameter ini juga dapat berupa alias yang terikat pada CMK tersebut. Untuk informasi selengkapnya, lihat Use of aliases.

    5c438b18-05be-40ad-b6c2-3be6752c****
    KeyVersionId

    string

    Yes

    Identifier unik global dari versi kunci.

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

    string

    No

    Menentukan apakah mode DryRun diaktifkan.

    • true: mengaktifkan mode DryRun.

    • false (default): menonaktifkan mode DryRun.

    Mode DryRun digunakan untuk menguji pemanggilan API, memverifikasi izin Anda terhadap resource, dan memeriksa validitas parameter. Jika Anda mengaktifkan mode DryRun, KMS selalu mengembalikan respons gagal beserta alasan kegagalannya. Alasan kegagalan tersebut meliputi:

    • 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

    Identifier unik global dari versi kunci.

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

    string

    Identifier unik global dari CMK.

    Catatan

    Jika Anda menentukan alias CMK sebagai parameter KeyId dalam permintaan, ID CMK yang terikat pada alias tersebut akan dikembalikan.

    5c438b18-05be-40ad-b6c2-3be6752c****
    RequestId

    string

    ID permintaan.

    475f1620-b9d3-4d35-b5c6-3fbdd941423d
    PublicKey

    string

    Kunci publik dalam format PEM.

    -----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAs5Yu9AEgATN2/e3nUz1K\nEy6ng8MSPutcse2/VECG/NUF9C6D4IsJ64ShzY3dcn34WYzTOe916eMJFxyrNrSw\nHtc4UOR5AvaoRrfpgu2uq+i70/ZXrWL+pGb1hgZV8cWheIHMxwrR3IiQlM5qN7EF\n9BdyWtyBfUGsp0Bn1VqlPc5G0x0a9xU2z9YtP994yDenNVIoIQ6Cov1lIEuwXAb2\n7boC41ePXwD0JWt41sP+rgCmpjBx00puIG+IlnoReEgI1ZGYmK98GgA/XzmNjZiD\nyvXJZAcM33Ue85+PkR5iHTtSEbi4QAoqpJabprUzz3Fin2j1dRrcacxGb7p31A9c\nJQIDAQAB\n-----END PUBLIC KEY-----\n

    Contoh

    Respons sukses

    JSONformat

    {
  "KeyVersionId": "2ab1a983-7072-4bbc-a582-584b5bd8****",
  "KeyId": "5c438b18-05be-40ad-b6c2-3be6752c****",
  "RequestId": "475f1620-b9d3-4d35-b5c6-3fbdd941423d",
  "PublicKey": "-----BEGIN PUBLIC KEY-----\\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAs5Yu9AEgATN2/e3nUz1K\\nEy6ng8MSPutcse2/VECG/NUF9C6D4IsJ64ShzY3dcn34WYzTOe916eMJFxyrNrSw\\nHtc4UOR5AvaoRrfpgu2uq+i70/ZXrWL+pGb1hgZV8cWheIHMxwrR3IiQlM5qN7EF\\n9BdyWtyBfUGsp0Bn1VqlPc5G0x0a9xU2z9YtP994yDenNVIoIQ6Cov1lIEuwXAb2\\n7boC41ePXwD0JWt41sP+rgCmpjBx00puIG+IlnoReEgI1ZGYmK98GgA/XzmNjZiD\\nyvXJZAcM33Ue85+PkR5iHTtSEbi4QAoqpJabprUzz3Fin2j1dRrcacxGb7p31A9c\\nJQIDAQAB\\n-----END PUBLIC KEY-----\\n"
}

    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.
    404 Forbidden.KeyNotFound The specified Key is not found. The error message returned because the specified CMK does not exist.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.