DescribeLiveCertificateList - ApsaraVideo Live

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.