All Products
Search

This Product

    Certificate Management Service:DescribeClientCertificateForSerialNumber

    Document Center

    Certificate Management Service:DescribeClientCertificateForSerialNumber

    Last Updated:Aug 24, 2026

    Mengkueri detail sertifikat klien atau sertifikat server secara batch berdasarkan nomor seri sertifikat.

    Catatan

    API ini telah ditinggalkan. Kami merekomendasikan migrasi ke cas(2020-06-30) - DescribeClientCertificate guna memperoleh fungsionalitas yang lebih baik dan dukungan berkelanjutan. Meskipun API yang telah ditinggalkan ini masih dapat diakses sementara, tidak akan ada pembaruan atau perbaikan bug lebih lanjut.

    Deskripsi operasi

    Deskripsi

    Operasi ini memungkinkan Anda untuk mengkueri detail sertifikat klien atau sertifikat server secara batch berdasarkan nomor seri sertifikat. Detail tersebut mencakup nomor seri, informasi subjek, konten, dan status sertifikat.

    Sebelum memanggil operasi ini, Anda harus telah membuat sertifikat klien atau sertifikat server.

    Untuk informasi tentang cara memanggil operasi API untuk membuat sertifikat klien, lihat:

    Untuk informasi tentang cara memanggil operasi API untuk membuat sertifikat server, lihat:

    Batas QPS

    Batas QPS per pengguna tunggal untuk operasi ini adalah 10 panggilan per detik. Jika batas terlampaui, panggilan API akan dibatasi (throttled), yang dapat memengaruhi bisnis Anda. Panggil operasi ini sesuai kebutuhan.

    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

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    yundun-cert:DescribeClientCertificateForSerialNumber

    get

    *Semua Sumber daya.

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    SerialNumber

    string

    Yes

    Nomor seri sertifikat klien atau sertifikat server yang ingin Anda kueri. Pisahkan beberapa nomor seri dengan koma (,).

    Catatan

    Anda dapat memanggil ListClientCertificate untuk mengkueri nomor seri semua sertifikat klien dan sertifikat server.

    084bde9cd233f0ddae33adc438cfbbbd****

    Saat Anda memanggil operasi ini, Anda harus menyertakan parameter permintaan umum API Alibaba Cloud selain parameter permintaan yang dijelaskan dalam topik ini. Untuk informasi lebih lanjut tentang parameter permintaan umum, lihat Parameter umum.

    Untuk format permintaan, lihat contoh permintaan di bagian Contoh dalam topik ini.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    ListCertificateResponse

    CertificateList

    array<object>

    Detail sertifikat klien atau sertifikat server.

    object

    Informasi sertifikat.

    X509Certificate

    string

    Konten sertifikat.

    -----BEGIN CERTIFICATE----- ...... -----END CERTIFICATE-----
    Identifier

    string

    Pengidentifikasi unik sertifikat.

    d3b95700998e47afc4d95f886579****
    SerialNumber

    string

    Nomor seri sertifikat.

    084bde9cd233f0ddae33adc438cfbbbd****
    SubjectDN

    string

    Atribut Distinguished Name (DN) sertifikat, yang menunjukkan subjek sertifikat. DN berisi informasi berikut:

    • C: Negara.

    • O: Organisasi.

    • OU: Departemen.

    • L: Kota.

    • ST: Provinsi atau negara bagian.

    • CN: Common name.

    C=CN,O=Alibaba Cloud Computing Co., Ltd.,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun
    CommonName

    string

    Common name sertifikat.

    aliyun.com
    OrganizationUnit

    string

    Nama departemen dalam organisasi yang terkait dengan sertifikat CA subordinat yang menerbitkan sertifikat ini.

    Security
    Organization

    string

    Nama organisasi yang terkait dengan sertifikat CA subordinat yang menerbitkan sertifikat ini.

    Alibaba Cloud Computing Co., Ltd
    Locality

    string

    Nama kota tempat organisasi yang terkait dengan sertifikat CA subordinat yang menerbitkan sertifikat ini berada.

    Hangzhou
    State

    string

    Nama provinsi atau negara bagian tempat organisasi yang terkait dengan sertifikat CA subordinat yang menerbitkan sertifikat ini berada.

    Zhejiang
    CountryCode

    string

    Kode negara tempat organisasi yang terkait dengan sertifikat CA subordinat yang menerbitkan sertifikat ini berada.

    Untuk informasi lebih lanjut tentang kode negara, lihat bagian Kode internasional di Kelola informasi perusahaan.

    CN
    Sans

    string

    Ekstensi Subject Alternative Name (SAN) sertifikat, yang menunjukkan nama domain atau alamat IP lain yang terkait dengan sertifikat.

    Parameter ini direpresentasikan sebagai string yang dikonversi dari array JSON. Setiap elemen dalam array JSON adalah struktur yang sesuai dengan ekstensi SAN. Setiap struktur ekstensi SAN berisi parameter berikut:

    • Type: Nilai Integer yang menunjukkan tipe ekstensi. Nilai valid:

      • 1: Alamat email.

      • 2: Nama domain.

      • 6: Uniform Resource Identifier (URI).

      • 7: Alamat IP.

    • Value: Nilai String yang menunjukkan konten ekstensi.

    [ {"Type": 7, "Value": "192.0.XX.XX"}, {"Type": 2, "Value": "www.aliyundoc.com"}, ]
    Status

    string

    Status sertifikat. Nilai valid:

    • ISSUE: Diterbitkan.

    • REVOKE: Dicabut.

    ISSUE
    BeforeDate

    string

    Tanggal penerbitan sertifikat. Formatnya adalah YYYY-MM-DD.

    2021-10-28T16:15Z
    AfterDate

    string

    Tanggal kedaluwarsa sertifikat. Formatnya adalah YYYY-MM-DD.

    2022-08-23T16:15Z
    Algorithm

    string

    Tipe algoritma enkripsi sertifikat. Nilai valid:

    • RSA: Algoritma RSA.

    • ECC: Algoritma ECC.

    • SM2: Algoritma SM2.

    RSA
    KeySize

    integer

    Panjang kunci sertifikat.

    4096
    SignAlgorithm

    string

    Algoritma tanda tangan sertifikat.

    SHA256WITHRSA
    CertificateType

    string

    Tipe sertifikat.

    SUB_ROOT
    ParentIdentifier

    string

    Jika parameter ini tidak kosong, sertifikat klien diterbitkan oleh Alibaba Cloud.

    1a83bcbb89e562885e40aa0108f5****
    Sha2

    string

    Sidik jari SHA-256 sertifikat.

    14dcc8afc7578e1fcec36d658f7e20de18f6957bbac42b373a66bc9de4e9****
    Md5

    string

    Sidik jari MD5 sertifikat.

    d3b95700998e47afc4d95f886579****
    Years

    integer

    Periode validitas sertifikat. Unit: tahun.

    1
    RequestId

    string

    ID permintaan.

    15C66C7B-671A-4297-9187-2C4477247A74

    Contoh

    Respons sukses

    JSONformat

    {
  "CertificateList": [
    {
      "X509Certificate": "-----BEGIN CERTIFICATE-----  ...... -----END CERTIFICATE-----",
      "Identifier": "d3b95700998e47afc4d95f886579****",
      "SerialNumber": "084bde9cd233f0ddae33adc438cfbbbd****",
      "SubjectDN": "C=CN,O=阿里云计算有限公司,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun",
      "CommonName": "aliyun.com",
      "OrganizationUnit": "Security",
      "Organization": "阿里云计算有限公司",
      "Locality": "Hangzhou",
      "State": "Zhejiang",
      "CountryCode": "CN",
      "Sans": "[ {\"Type\": 7, \"Value\": \"192.0.XX.XX\"}, {\"Type\": 2, \"Value\": \"www.aliyundoc.com\"}, ]",
      "Status": "ISSUE",
      "BeforeDate": "2021-10-28T16:15Z",
      "AfterDate": "2022-08-23T16:15Z",
      "Algorithm": "RSA",
      "KeySize": 4096,
      "SignAlgorithm": "SHA256WITHRSA",
      "CertificateType": "SUB_ROOT",
      "ParentIdentifier": "1a83bcbb89e562885e40aa0108f5****",
      "Sha2": "14dcc8afc7578e1fcec36d658f7e20de18f6957bbac42b373a66bc9de4e9****",
      "Md5": "d3b95700998e47afc4d95f886579****",
      "Years": 1
    }
  ],
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.