Queries the certificates of a specified domain name or all the domain names within your Alibaba Cloud account.

Usage note

If you specify the domain name or domain names in the request, ApsaraVideo Live returns certificates of the specified domain. If you do not specify the domain name in the request, ApsaraVideo Live returns all certificates belonging to the account.

QPS limit

A single user can perform a maximum of 50 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.

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 DescribeLiveCertificateList

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

DomainName String No demo.aliyundoc.com

The streaming domain and ingest domain.

Response parameters

Parameter Type Example Description
CertificateListModel Struct

The information about the returned certificates.

CertList Array of Cert

The details of each certificate.

Cert
CertId Long 123456

The ID of the certificate.

CertName String Cert-****

The name of the certificate.

Common String example.net

The common name of the certificate.

Fingerprint String ****

The fingerprint of the certificate.

Issuer String *****

The certificate authority (CA) that issued the certificate.

LastTime Long 1512388659

The time when the certificate was issued. Unit: seconds.

Count Integer 2

The number of certificates.

RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

The ID of the request.

Examples

Sample requests

http(s)://live.aliyuncs.com/?Action=DescribeLiveCertificateList
&<Common request parameters>

Sample success responses

XML format

<DescribeLiveCertificateListResponse>
  <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
  <CertificateListModel>
        <Count>2</Count>
        <CertList>
              <Cert>
                    <Fingerprint>****</Fingerprint>
                    <Issuer>*****</Issuer>
                    <CertId>123456</CertId>
                    <CertName>Cert-****</CertName>
                    <LastTime>1512388659</LastTime>
                    <Common>example.net</Common>
              </Cert>
        </CertList>
  </CertificateListModel>
</DescribeLiveCertificateListResponse>

JSON format

{
    "DescribeLiveCertificateListResponse": {
        "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
        "CertificateListModel": {
            "Count": 2,
            "CertList": {
                "Cert": {
                    "Fingerprint": "****",
                    "Issuer": "*****",
                    "CertId": 123456,
                    "CertName": "Cert-****",
                    "LastTime": 1512388659,
                    "Common": "example.net"
                }
            }
        }
    }
}

Error codes

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