All Products
Search

This Product

    Certificate Management Service:ListClientCertificate

    Document Center

    Certificate Management Service:ListClientCertificate

    Last Updated:Jun 10, 2026

    Mencantumkan semua sertifikat klien dan sertifikat server yang diterbitkan oleh sebuah private certificate authority (CA).

    Deskripsi operasi

    API ini melakukan kueri berpaginasi untuk mengambil detail dari semua sertifikat klien dan server yang telah Anda buat. Detail ini meliputi pengidentifikasi unik, nomor seri, informasi subjek, isi, dan status dari setiap sertifikat.

    Batas QPS

    Batas QPS untuk satu pengguna adalah 10 panggilan per detik. Jika Anda melebihi batas ini, panggilan API Anda akan dibatasi (throttled), yang dapat memengaruhi bisnis Anda. Panggil API ini dengan kecepatan yang wajar.

    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:ListClientCertificate

    list

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    CurrentPage

    integer

    No

    Nomor halaman. Nilai default: 1.

    1
    ShowSize

    integer

    No

    Jumlah entri per halaman. Nilai default: 20.

    20
    Identifier

    string

    No

    Pengidentifikasi unik dari sertifikat klien atau server yang ingin Anda kueri.

    Catatan

    Anda dapat memanggil ListClientCertificate untuk mengkueri pengidentifikasi unik dari semua sertifikat klien dan server.

    160ae6bb538d538c70c01f81dcf2****
    ResourceGroupId

    string

    No

    ID grup sumber daya. Panggil operasi ListResources untuk mendapatkan ID ini.

    rg-ae******4wia

    Saat Anda memanggil API ini, Anda harus menyertakan parameter permintaan umum untuk API Alibaba Cloud selain parameter permintaan yang dijelaskan dalam topik ini.

    Untuk format permintaan, lihat contoh permintaan di bagian Examples pada topik ini.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    ListCertificateResponse2

    CertificateList

    array<object>

    Daftar detail tentang sertifikat klien atau server.

    object

    Sebuah objek.

    X509Certificate

    string

    Isi sertifikat.

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

    string

    Pengidentifikasi unik sertifikat.

    d3b95700998e47afc4d95f886579****
    SerialNumber

    string

    Nomor seri sertifikat.

    62b2b943a32d96883a6650e672ea0276****
    SubjectDN

    string

    Distinguished Name (DN) dari sertifikat. DN menunjukkan pengguna sertifikat dan berisi informasi berikut:

    • C: Negara.

    • O: Organisasi.

    • OU: Departemen.

    • L: Kota.

    • ST: Provinsi atau negara bagian.

    • CN: Nama umum (common name).

    C=CN,O=阿里云计算有限公司,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun
    CommonName

    string

    Nama umum (common name) dari sertifikat.

    aliyundoc.com
    OrganizationUnit

    string

    Nama departemen dari organisasi yang terkait dengan sertifikat certificate authority (CA) bawahan yang menerbitkan.

    Security
    Organization

    string

    Nama organisasi yang terkait dengan sertifikat CA bawahan yang menerbitkan.

    阿里云计算有限公司
    Locality

    string

    Kota tempat organisasi yang terkait dengan sertifikat CA bawahan yang menerbitkan berada.

    Hangzhou
    State

    string

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

    Zhejiang
    CountryCode

    string

    Kode negara dari negara tempat organisasi yang terkait dengan sertifikat CA bawahan yang menerbitkan berada.

    Untuk informasi lebih lanjut tentang kode negara, lihat bagian Country codes pada Manage company information.

    CN
    Sans

    string

    Ekstensi Subject Alternative Name (SAN) dari sertifikat. Ekstensi ini menunjukkan nama domain lain, alamat IP, dan lain-lain yang terkait dengan sertifikat.

    Parameter ini adalah string yang dikonversi dari sebuah JSON array. Setiap elemen dalam JSON array adalah struct yang berkorespondensi dengan satu ekstensi SAN. Setiap struct ekstensi SAN berisi parameter berikut:

    • Type: Tipe ekstensi. Parameter ini bertipe Integer. Nilai yang valid:

      • 1: alamat email.

      • 2: nama domain.

      • 6: Uniform Resource Identifier (URI).

      • 7: alamat IP.

    • Value: Isi ekstensi. Parameter ini bertipe String.

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

    string

    Status sertifikat. Nilai yang valid:

    • ISSUE: Sertifikat telah diterbitkan.

    • REVOKE: Sertifikat telah dicabut.

    ISSUE
    BeforeDate

    integer

    Tanggal penerbitan sertifikat. Nilai ini adalah UNIX timestamp. Satuan: milidetik.

    1634283958000
    AfterDate

    integer

    Tanggal kedaluwarsa sertifikat. Nilai ini adalah UNIX timestamp. Satuan: milidetik.

    1665819958000
    Algorithm

    string

    Tipe algoritma enkripsi sertifikat. Nilai yang 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. Nilai yang valid:

    • CLIENT: sertifikat klien.

    • SERVER: sertifikat server.

    SERVER
    ParentIdentifier

    string

    Pengidentifikasi unik dari sertifikat CA bawahan yang menerbitkan sertifikat ini.

    160ae6bb538d538c70c01f81dcf2****
    Sha2

    string

    Sidik jari SHA-256 dari sertifikat.

    14dcc8afc7578e1fcec36d658f7e20de18f6957bbac42b373a66bc9de4e9****
    Md5

    string

    Sidik jari MD5 dari sertifikat.

    d3b95700998e47afc4d95f886579****
    Days

    integer

    Masa berlaku sertifikat. Satuan: hari.

    365
    ResourceGroupId

    string

    ID grup sumber daya tempat sertifikat berada.

    rg-acfmyxa2uv6cu5a
    CustomIdentifier

    string

    Pengidentifikasi kustom, yang merupakan kunci unik.

    ****48d8d3ecc9976d9ecd2b2f25****
    Id

    integer

    ID primary key dari sertifikat.

    AliasName

    string

    Nama sertifikat yang diterbitkan.

    CurrentPage

    integer

    Nomor halaman dari halaman yang dikembalikan.

    1
    PageCount

    integer

    Jumlah total halaman.

    1
    ShowSize

    integer

    Jumlah sertifikat yang dikembalikan per halaman.

    20
    TotalCount

    integer

    Jumlah total sertifikat klien dan server yang dikueri.

    1
    RequestId

    string

    ID permintaan.

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

    integer

    Parameter paging: jumlah maksimum entri dalam set hasil.

    Contoh

    Respons sukses

    JSONformat

    {
  "CertificateList": [
    {
      "X509Certificate": "-----BEGIN CERTIFICATE-----  ...... -----END CERTIFICATE-----",
      "Identifier": "d3b95700998e47afc4d95f886579****",
      "SerialNumber": "62b2b943a32d96883a6650e672ea0276****",
      "SubjectDN": "C=CN,O=阿里云计算有限公司,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun",
      "CommonName": "aliyundoc.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": 1634283958000,
      "AfterDate": 1665819958000,
      "Algorithm": "RSA",
      "KeySize": 4096,
      "SignAlgorithm": "SHA256WITHRSA",
      "CertificateType": "SERVER",
      "ParentIdentifier": "160ae6bb538d538c70c01f81dcf2****",
      "Sha2": "14dcc8afc7578e1fcec36d658f7e20de18f6957bbac42b373a66bc9de4e9****",
      "Md5": "d3b95700998e47afc4d95f886579****",
      "Days": 365,
      "ResourceGroupId": "rg-acfmyxa2uv6cu5a",
      "CustomIdentifier": "****48d8d3ecc9976d9ecd2b2f25****",
      "Id": 0,
      "AliasName": ""
    }
  ],
  "CurrentPage": 1,
  "PageCount": 1,
  "ShowSize": 20,
  "TotalCount": 1,
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74",
  "MaxResults": 0
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.