Queries the certificate information about a domain name.

Usage note

The domain name is mandatory for calling this API.

QPS limit

A single user can perform a maximum of 100 queries per second (QPS). Throttling is triggered when the number of calls per second exceeds the QPS limit. The throttling may affect your business. Thus, we recommend that you observe the QPS limit on this operation. For more information about what a single user means and the QPS details, see QPS limit on an API operation in ApsaraVideo Live.


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 DescribeLiveDomainCertificateInfo

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

DomainName String Yes example.com

The streaming domain name or ingest domain.

RegionId String No cn-shanghai

The ID of the region where the streaming domain resides.

Response parameters

Parameter Type Example Description
CertInfos Array of CertInfo

The certificate information about the domain name.

CertDomainName String example.com

The domain name that matches the certificate.

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

The time when the certificate expires. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

CertLife String 3 months
The validity period of the certificate. Unit: months or years.
  • If the validity period is greater than 12 months, XX years XX months is displayed. For example, 2 years 3 months indicates that the validity period is 2 years and 3 months.
  • If the validity period is less than 12 months, XX months is displayed. For example, 3 months indicates that the validity period is 3 months.
CertName String Cert-****

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 user-uploaded certificate.
DomainName String example.com

The streaming domain name.

SSLProtocol String on

The status of HTTPS. Valid values:

  • on: HTTPS is enabled.
  • off: HTTPS is disabled.
SSLPub String yourSSLPub

The public key of the certificate.

Status String success

The status of the certificate. Valid values:

  • success: The certificate is effective.
  • checking: The system is checking whether the domain name is mapped to the canonical name (CNAME) that is assigned by ApsaraVideo Live.
  • cname_error: The domain name is not mapped to the CNAME that is assigned by ApsaraVideo Live.
  • domain_invalid: The domain name contains invalid characters.
  • unsupport_wildcard: Wildcard domain names are not supported.
  • applying: The certificate is in the application progress.
  • failed: The application for the certificate has failed.
RequestId String 5C1E43DC-9E51-4771-82C0-7D5ECEB547A1

The ID of the request.


Sample requests

&<Common request parameters>

Sample success responses

XML format

              <CertLife>3 months</CertLife>
              <CertOrg>Let's Encrypt</CertOrg>

JSON format

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

Error codes

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

Special error codes

Error code

Error message

HTTP status code



The domain provided does not belong to you.


The error message returned because the domain name does not exist or does not belong to you.