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

ParameterTypeRequiredExampleDescription
ActionStringNoDescribeDcdnDomainCertificateInfo

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

DomainNameStringYesexample.com

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

Response parameters

ParameterTypeExampleDescription
CertInfosArray of CertInfo

The certificate information of the domain name.

CertInfo
CertDomainNameStringexample.com

The domain name that matches the certificate.

CertExpireTimeString2018-06-03T22:03:39Z

The expiration time of the certificate.

CertLifeString3 months

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

CertNameStringcert-example.com

The name of the certificate.

CertOrgStringLet's Encrypt

The certificate authority (CA) that issued the certificate.

CertTypeStringcas

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
DomainNameStringexample.com

The accelerated domain name.

SSLProtocolStringon

The status of HTTPS. Valid values:

  • on: enabled
  • off: disabled
SSLPubStringxxxx

The public key of the certificate.

StatusStringsuccess

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.
RequestIdString5C1E43DC-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.