Queries the server certificates of a listener that uses SSL over TCP.

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 ListListenerCertificates

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

ListenerId String Yes lsn-j49ht1jxxqyg45****@80

The ID of the listener. Specify the ID of a listener that uses SSL over TCP.

NextToken String No FFmyTO70tTpLG6I3FmYAXGKPd****

The pagination token that is used in the next request to retrieve a new page of results. Valid values:

  • You do not need to specify this parameter for the first request.
  • You must specify the token that is obtained from the previous query as the value of NextToken.
MaxResults Integer No 20

The number of entries to return on each page. Valid values: 1 to 100. Default value: 20.

RegionId String No cn-hangzhou

The ID of the region where the Network Load Balancer (NLB) instance is deployed.

You can call the DescribeRegions operation to query the most recent region list.

Response parameters

Parameter Type Example Description
RequestId String 2198BD6D-9EBB-5E1C-9C48-E0ABB79CF831

The request ID.

CertificateIds Array of String [ "931****-cn-hangzhou"]

The server certificates.

TotalCount Integer 1

The total number of entries returned.

NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

The returned value of NextToken is a pagination token, which can be used in the next request to retrieve a new page of results. Valid values:

  • You do not need to specify this parameter for the first request.
  • You must specify the token that is obtained from the previous query as the value of NextToken.
MaxResults Integer 20

The number of entries returned per page. Valid values: 1 to 100. Default value: 20.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ListListenerCertificates
&ListenerId=lsn-j49ht1jxxqyg45****@80
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&MaxResults=20
&RegionId=cn-hangzhou
&Common request parameters

Sample success responses

XML format

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

<ListListenerCertificatesResponse>
    <RequestId>2198BD6D-9EBB-5E1C-9C48-E0ABB79CF831</RequestId>
    <CertificateIds>[ "931****-cn-hangzhou"]</CertificateIds>
    <TotalCount>1</TotalCount>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <MaxResults>20</MaxResults>
</ListListenerCertificatesResponse>

JSON format

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

{
  "RequestId" : "2198BD6D-9EBB-5E1C-9C48-E0ABB79CF831",
  "CertificateIds" : [ "[ \"931****-cn-hangzhou\"]" ],
  "TotalCount" : 1,
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "MaxResults" : 20
}

Error codes

For a list of error codes, see Service error codes.