All Products
Search
Document Center

CDN:DescribeCdnCertificateList

Last Updated:Mar 28, 2026

Queries the certificates of accelerated domain names.

Note

This API has been deprecated. We recommend migrating to Cdn(2018-05-10) - DescribeCdnSSLCertificateList for enhanced functionality and continued support. While the deprecated API remains temporarily accessible, no further updates or bug fixes will be provided.

Operation description

Note

Each account can call this operation up to 30 times per second.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

DomainName

string

No

The accelerated domain name. Separate multiple accelerated domain names with commas (,).

If you do not specify an accelerated domain name, SSL certificates of all your accelerated domain names are queried.

example.com

Response elements

Element

Type

Description

Example

object

RequestId

string

The ID of the request.

FC0E34AC-0239-44A7-AB0E-800DE522C8DA

CertificateListModel

object

Details about certificates.

Count

integer

The number of certificates that are returned.

2

CertList

object

Cert

array<object>

The list of certificates.

object

LastTime

integer

The timestamp.

1512388610

Fingerprint

string

The fingerprint of the certificate.

2ED68FD33786C5B42950D40A6C50353575BB****

CertName

string

The name of the certificate.

Certificate1

Issuer

string

The certificate authority (CA) that issued the certificate.

CO****

CertId

integer

The ID of the certificate.

1

Common

string

The Common Name (CN) attribute of the certificate. In most cases, the CN is a domain name.

example.com

Examples

Success response

JSON format

{
  "RequestId": "FC0E34AC-0239-44A7-AB0E-800DE522C8DA",
  "CertificateListModel": {
    "Count": 2,
    "CertList": {
      "Cert": [
        {
          "LastTime": 1512388610,
          "Fingerprint": "2ED68FD33786C5B42950D40A6C50353575BB****",
          "CertName": "证书1",
          "Issuer": "CO****",
          "CertId": 1,
          "Common": "example.com"
        }
      ]
    }
  }
}

Error response

JSON format

{
    "CertificateListModel": {
        "Count": 2,
        "CertList": {
            "Cert": [
                {
                    "CertName": "证书1",
                    "Issuer": "xxx",
                    "LastTime": 1512388610,
                    "CertId": xxx,
                    "Common": "test",
                    "Fingerprint": "xxx"
                },
                {
                    "CertName": "证书2",
                    "Issuer": "xxx",
                    "LastTime": 1512388659,
                    "CertId": xxx,
                    "Common": "test",
                    "Fingerprint": "xxx"
                }
            ]
        }
    },
    "RequestId": "FC0E34AC-0239-44A7-AB0E-800DE522C8DA"
}

Error codes

HTTP status code

Error code

Error message

Description

400 FlowControlError The request was denied due to flow control. The request was denied due to throttling.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.