Queries information about all certificates that belong to your account.

Note The maximum number of times that each user can call this operation per second is 100.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeDcdnHttpsDomainList

The operation that you want to perform. Set the value to DescribeDcdnHttpsDomainList.

PageNumber Integer No 1

The number of pages to return. Valid values: 1 to 100000.

PageSize Integer No 2

The number of entries to return on each page. Valid values: 1 to 500. Default value: 20.

Keyword String No cert

The keyword used for search.

Response parameters

Parameter Type Example Description
CertInfos Array of CertInfo

The certificate information about the domain name.

CertCommonName String *.com

The returned primary domain name of the certificate.

CertExpireTime String 2018-12-26 14:45:09

The time when the certificate expires.

CertName String cert

The name of the certificate.

CertStartTime String 2018-11-26 14:45:09

The time when the certificate became effective.

CertStatus String mismatch

The status of the certificate. Valid values:

  • ok: The certificate is working as expected.
  • mismatch: The certificate does not match the specified domain name.
  • expired: The certificate has expired.
  • expire_soon: The certificate is about to expire.
CertType String upload

The type of the certificate. Valid values:

  • free: A free certificate.
  • cas: A certificate that is purchased through Alibaba Cloud SSL Certificates Service.
  • upload: A user-uploaded certificate.
CertUpdateTime String 2019-01-08 18:33:16

The time when the certificate was updated.

DomainName String *.com

The accelerated domain name for which the certificate information was queried.

RequestId String F5E8DF64-7175-4186-9B06-F002C0BBD0C5

The ID of the request.

TotalCount Integer 16

The total number of entries returned.


Sample requests

&<Common request parameters>

Sample success responses

XML format

              <CertUpdateTime>2019-01-08 18:33:16</CertUpdateTime>
              <CertExpireTime>2018-12-26 14:45:09</CertExpireTime>
              <CertStartTime>2018-11-26 14:45:09</CertStartTime>

JSON format

    "CertInfos": {
        "CertInfo": [
                "CertUpdateTime": "2019-01-08 18:33:16",
                "CertType": "upload",
                "CertName": "cert",
                "DomainName": "*.com",
                "CertStatus": "mismatch",
                "CertExpireTime": "2018-12-26 14:45:09",
                "CertStartTime": "2018-11-26 14:45:09",
                "CertCommonName": "*.com"
    "TotalCount": 16,
    "RequestId": "F5E8DF64-7175-4186-9B06-F002C0BBD0C5"

Error codes

HttpCode Error code Error message Description
400 NoHttpsDomain Your account does not have any HTTPS domain. The error message returned because your account does not have a domain name that has HTTPS enabled.

For a list of error codes, visit the API Error Center.