查询SSL证书列表_视频直播(LIVE)-阿里云帮助中心

调用DescribeLiveSSLCertificateList查询SSL证书列表。

使用说明

如果请求中指定域名，则返回域名下的证书。如果请求中未指定域名，则返回请求账号下的所有证书。

QPS限制

本接口的单用户QPS限制为50次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeLiveSSLCertificateList	系统规定参数。取值：DescribeLiveSSLCertificateList。
DomainName	String	否	www.example.com	加速域名，仅支持查询单个域名。
PageNumber	Long	否	1	页码。默认值：1 。
PageSize	Long	否	20	分页大小。取值：1~1000之间的任意整数。
SearchKeyword	String	否	证书名称模糊查询。 certabc	证书名称模糊查询。

返回数据

名称	类型	示例值	描述
CertificateListModel	Object		证书列表信息。
CertList	Array of Cert		证书列表信息。
Cert
CertId	Long	9128192	证书ID。
CertName	String	test	证书名称。
CertRegion	String	cn-hangzhou	证书所在地域。支持cn-hangzhou和ap-southeast-1，默认cn-hangzhou。
Common	String	example.com	证书中的CN属性，一般是一个域名。
Fingerprint	String	933c6ddee95c9c41a40f9f50493d82be03ad87bf	证书指纹。
Issuer	String	yourCertIssuer	证书发行商。
LastTime	Long	1679896965	证书最后修改时间，单位：毫秒。
Count	Integer	2	证书数量。
PageNumber	Long	2	当前页数，起始值为1，默认为1。
PageSize	Long	20	每页大小，取值：1~1000之间的任意整数。
RequestId	String	E9D3257A-1B7C-414C-90C1-8D07AC47BCAC	请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveSSLCertificateList
&DomainName=www.example.com
&PageNumber=1
&PageSize=20
&SearchKeyword=证书名称模糊查询。	certabc
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeLiveSSLCertificateListResponse>
    <CertificateListModel>
        <CertList>
            <CertId>9128192</CertId>
            <CertName>test</CertName>
            <CertRegion>cn-hangzhou</CertRegion>
            <Common>example.com</Common>
            <Fingerprint>933c6ddee95c9c41a40f9f50493d82be03ad87bf</Fingerprint>
            <Issuer>yourCertIssuer</Issuer>
            <LastTime>1679896965</LastTime>
        </CertList>
        <Count>2</Count>
        <PageNumber>2</PageNumber>
        <PageSize>20</PageSize>
    </CertificateListModel>
    <RequestId>E9D3257A-1B7C-414C-90C1-8D07AC47BCAC</RequestId>
</DescribeLiveSSLCertificateListResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "CertificateListModel" : {
    "CertList" : [ {
      "CertId" : 9128192,
      "CertName" : "test",
      "CertRegion" : "cn-hangzhou",
      "Common" : "example.com",
      "Fingerprint" : "933c6ddee95c9c41a40f9f50493d82be03ad87bf",
      "Issuer" : "yourCertIssuer",
      "LastTime" : 1679896965
    } ],
    "Count" : 2,
    "PageNumber" : 2,
    "PageSize" : 20
  },
  "RequestId" : "E9D3257A-1B7C-414C-90C1-8D07AC47BCAC"
}

错误码

访问错误中心查看更多错误码。