Queries accelerated domain names based on the certificate information.

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 Yes DescribeDcdnDomainByCertificate

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

SSLPub String Yes xxx

The public key of the certificate.

You must use Base64 encoding schemes and then the encodeURIComponent method to encode the public key. PEM files are supported.

Response parameters

Parameter Type Example Description
CertInfos Array of CertInfo

The certificate information for the returned domain name.

CertInfo
CertCaIsLegacy String yes

Indicates whether the CA certificate has been revoked. Valid values:

  • yes: The certificate has been revoked.
  • no: The certificate is normal.
CertExpireTime String Nov 29 00:00:00 2016 GMT

The time when the certificate expires.

CertExpired String yes

Indicates whether the certificate has expired. Valid values:

  • yes: The certificate has expired.
  • no: The certificate has not expired.
CertStartTime String Nov 29 23:59:59 2017 GMT

The time when the certificate became effective.

CertSubjectCommonName String test.example.com

The name of the certificate owner.

CertType String RSA

The type of certificate. Valid values: RSA, DSA, and ECDSA.

DomainList String example1.com,example2.com

The list of domain names that use the certificate.

If one or more domain names are returned, the domain names are matched with the specified certificate. Multiple domain names are separated with commas (,).

DomainNames String *.example1.com,example2.com

The domain names (DNS fields) that match the certificate. Multiple domain names are separated with commas (,).

Issuer String C=US, O=Symantec Corporation, OU=Symantec Trust Network, OU=Domain Validated SSL, CN=Symantec Basic DV SSL CA - G1

The certificate authority that issues the certificate.

RequestId String ASAF2FDS-12SADSA-DDSAE3D-DSADCD4C-CDADS2D

The ID of the request.

Examples

Sample requests

http(s)://dcdn.aliyuncs.com/? Action=DescribeDcdnDomainByCertificate
&SSLPub=xxx
&<Common request parameters>

Sample success responses

XML format

<DescribeDcdnDomainByCertificateResponse>
  <RequestId>ASAF2FDS-12SADSA-DDSAE3D-DSADCD4C-CDADS2D</RequestId>
  <content>
        <Issuer>C=US, O=Symantec Corporation, OU=Symantec Trust Network, OU=Domain Validated SSL, CN=Symantec Basic DV SSL CA - G1</Issuer>
        <CertType>RSA</CertType>
        <CertSubjectCommonName>test.example.com</CertSubjectCommonName>
        <CertStartTime>Nov 29 23:59:59 2017 GMT</CertStartTime>
        <CertExpireTime>Nov 29 00:00:00 2016 GMT</CertExpireTime>
        <DomainNames>*.example1.com,example2.com</DomainNames>
        <DomainList>example1.com,example2.com</DomainList>
        <CertExpired>yes</CertExpired>
        <CertCaIsLegacy>yes</CertCaIsLegacy>
  </content>
</DescribeDcdnDomainByCertificateResponse>

JSON format

{
    "RequestId": "ASAF2FDS-12SADSA-DDSAE3D-DSADCD4C-CDADS2D",
    "content": [
        {
            "Issuer": "C=US, O=Symantec Corporation, OU=Symantec Trust Network, OU=Domain Validated SSL, CN=Symantec Basic DV SSL CA - G1",
            "CertType": "RSA",
            "CertSubjectCommonName": "test.example.com",
            "CertStartTime": "Nov 29 23:59:59 2017 GMT",
            "CertExpireTime": "Nov 29 00:00:00 2016 GMT",
            "DomainNames": "*.example1.com,example2.com",
            "DomainList": "example1.com,example2.com",
            "CertExpired": "yes",
            "CertCaIsLegacy": "yes"
        }
     ]
}

Error codes

HTTP status code Error code Error message Description
400 Certificate.FormatError The format of the certificate is invalid. The error message returned because the certificate format is invalid.
400 SSLPub.MissingParameter The SSLPub parameter is required. The error message returned because the value of the SSLPub parameter must be specified.
400 Decode.Error Error decoding the SSLPub or SSLPri certificate. The error message returned because the public key or the private key of the certificate has failed to be decoded.
500 InternalError An internal error occurred; please try again later. The error message returned because an internal error has occurred. Try again later. If the error persists, submit a ticket.

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