Queries the certificate information of a specified accelerated domain name.

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

Debugging

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 No DescribeDcdnDomainCertificateInfo

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

DomainName String Yes example.com

The accelerated domain name. You can specify only one domain name in each request.

Response parameters

Parameter Type Example Description
CertInfos Array of CertInfo

The certificate information of the domain name.

CertInfo
CertDomainName String example.com

The domain name that matches the certificate.

CertExpireTime String 2018-06-03T22:03:39Z

The expiration time of the certificate.

CertLife String 3 months

The validity period of the certificate. Unit: months or years.

CertName String cert-example.com

The name of the certificate.

CertOrg String Let's Encrypt

The certificate authority (CA) that issued the certificate.

CertType String cas

The type of the certificate. Valid values:

  • free: a free certificate
  • cas: a certificate that is purchased from Alibaba Cloud SSL Certificates Service
  • upload: a certificate that is uploaded by the user
DomainName String example.com

The accelerated domain name.

SSLProtocol String on

The status of HTTPS. Valid values:

  • on: enabled
  • off: disabled
SSLPub String xxxx

The public key of the certificate.

Status String success

The status of the certificate. Valid values:

  • success: The certificate has taken effect.
  • checking: The system is checking whether the domain name is using Dynamic Route for CDN (DCDN).
  • cname_error: The domain name is not using DCDN.
  • domain_invalid: The domain name contains invalid characters.
  • unsupport_wildcard: The wildcard domain name is not supported.
  • applying: Certificate application is in progress.
  • get_token_timeout: The certificate application request has timed out.
  • check_token_timeout: The verification has timed out.
  • get_cert_timeout: The request to obtain the certificate has timed out.
  • failed: The certificate application request failed.
RequestId String 5C1E43DC-9E51-4771-82C0-7D5ECEB547A1

The ID of the request.

Examples

Sample requests

http(s)://dcdn.aliyuncs.com/?Action=DescribeDcdnDomainCertificateInfo
&DomainName=example.com
&<Common request parameters>

Sample success responses

XML format

<DescribeDcdnDomainCertificateInfoResponse>
      <CertInfos>
            <CertInfo>
                  <Status>success</Status>
                  <CertLife>3 months</CertLife>
                  <SSLProtocol>on</SSLProtocol>
                  <CertType>cas</CertType>
                  <CertName>cert-example.com</CertName>
                  <CertDomainName>example.com</CertDomainName>
                  <DomainName>example.com</DomainName>
                  <CertOrg>Let's Encrypt</CertOrg>
                  <CertExpireTime>2018-06-03T22:03:39Z</CertExpireTime>
            </CertInfo>
      </CertInfos>
      <RequestId>5C1E43DC-9E51-4771-82C0-7D5ECEB547A1</RequestId>
</DescribeDcdnDomainCertificateInfoResponse>

JSON format

{
  "CertInfos": {
    "CertInfo": [
      {
        "Status": "success",
        "CertLife": "3 months",
        "SSLProtocol": "on",
        "CertType": "cas",
        "CertName": "cert-example.com",
        "CertDomainName": "example.com",
        "DomainName": "example.com",
        "CertOrg": "Let's Encrypt",
        "CertExpireTime": "2018-06-03T22:03:39Z"
      }
    ]
  },
  "RequestId": "5C1E43DC-9E51-4771-82C0-7D5ECEB547A1"
}

Error codes

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