调用ListListenerCertificates查询监听绑定的证书列表。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String ListListenerCertificates

系统规定参数。取值:ListListenerCertificates

RegionId String cn-hangzhou

全球加速实例所在的地域ID,仅取值cn-hangzhou

AcceleratorId String ga-bp1odcab8tmno0hdq****

全球加速实例ID。

Role String default

证书的角色。取值:

  • default:默认证书。
  • additional:扩展证书。

不传入值时,默认证书和扩展证书都将返回在证书列表中。

ListenerId String lsr-bp1bpn0kn908w4nbw****

监听ID。

NextToken String caeba0bbb2be03f84eb48b699f0a4883

是否拥有下一次查询的令牌(Token)。取值:

  • 第一次查询和没有下一次查询时,均无需填写。
  • 如果有下一次查询,取值为上一次API调用返回的NextToken值。
MaxResults Integer 50

本次读取的最大数据记录数量。

取值范围:1~50,默认值为20

返回数据

名称 类型 示例值 描述
RequestId String 6FEA0CF3-D3B9-43E5-A304-D217037876A8

请求ID。

TotalCount Integer 1

列表条目数。

NextToken String caeba0bbb2be03f84eb48b699f0a4883

是否拥有下一次查询的令牌(Token)。取值:

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值,该取值表示下一次查询开始的令牌。
MaxResults Integer 20

本次读取的最大数据记录数量。

Certificates Array of Certificates

证书列表。

CertificateId String 6092**-cn-hangzhou

证书ID。

IsDefault Boolean true

是否为默认证书。

  • true:默认证书。
  • false:扩展证书。
Domain String example.com

扩展证书绑定的域名。

默认证书不返回该字段。

State String active

证书的状态。

  • active:证书绑定监听并生效。
  • updating:扩展证书替换中。

示例

请求示例

http(s)://[Endpoint]/?Action=ListListenerCertificates
&RegionId=cn-hangzhou
&AcceleratorId=ga-bp1odcab8tmno0hdq****
&Role=default
&ListenerId=lsr-bp1bpn0kn908w4nbw****
&NextToken=caeba0bbb2be03f84eb48b699f0a4883
&MaxResults=50
&公共请求参数

正常返回示例

XML格式

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

<ListListenerCertificatesResponse>
    <RequestId>6FEA0CF3-D3B9-43E5-A304-D217037876A8</RequestId>
    <TotalCount>1</TotalCount>
    <NextToken>caeba0bbb2be03f84eb48b699f0a4883</NextToken>
    <MaxResults>20</MaxResults>
    <Certificates>
        <CertificateId>6092**-cn-hangzhou</CertificateId>
        <IsDefault>true</IsDefault>
        <Domain>example.com</Domain>
        <State>active</State>
    </Certificates>
</ListListenerCertificatesResponse>

JSON格式

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

{
  "RequestId" : "6FEA0CF3-D3B9-43E5-A304-D217037876A8",
  "TotalCount" : 1,
  "NextToken" : "caeba0bbb2be03f84eb48b699f0a4883",
  "MaxResults" : 20,
  "Certificates" : [ {
    "CertificateId" : "6092**-cn-hangzhou",
    "IsDefault" : true,
    "Domain" : "example.com",
    "State" : "active"
  } ]
}

错误码

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