DescribeDcdnDomainByCertificate - API Reference| Alibaba Cloud Documentation Center

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	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	example.aliyundoc.com	The name of the certificate owner.
CertType	String	RSA	The type of certificate. Valid values: RSA, DSA, and ECDSA.
DomainList	String	example.com,example.org	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	*.example.com,example.org	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>example.aliyundoc.com</CertSubjectCommonName>
        <CertStartTime>Nov 29 23:59:59 2017 GMT</CertStartTime>
        <CertExpireTime>Nov 29 00:00:00 2016 GMT</CertExpireTime>
        <DomainNames>*.example.com,example.org</DomainNames>
        <DomainList>example.com,example.org</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": "example.aliyundoc.com",
            "CertStartTime": "Nov 29 23:59:59 2017 GMT",
            "CertExpireTime": "Nov 29 00:00:00 2016 GMT",
            "DomainNames": "*.example.com,example.org",
            "DomainList": "example.com,example.org",
            "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.