リスナーに関連付けられている証明書を照会します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須／任意 例: 説明　
操作 String 必須 ListListenerCertificates

実行する操作です。 値をListListenerCertificatesに設定します。

RegionId String 必須 cn-hangzhou

Global Accelerator (GA) インスタンスがデプロイされているリージョンのID。 値をcn-hangzhouに設定します。

AcceleratorId String 必須 ga-bp1odcab8tmno0hdq****

GA インスタンスの ID です。

Role String 任意 default

証明書のタイプ。 有効な値：

  • default: デフォルトの証明書
  • additional: 追加の証明書

このパラメーターを設定しない場合、デフォルトおよび追加の証明書がデフォルトで返されます。

ListenerId String 必須 lsr-bp1bpn0kn908w4nbw****

リスナーの ID を示します。

NextToken String 任意 caeba0bbb2be03f84eb48b699f0a4883

次のクエリの開始点を決定するトークン。 有効な値：

  • これが最初で唯一のクエリの場合は、このパラメーターを無視します。
  • 次のクエリを実行する場合は、ListListenerCertificates操作の最後の呼び出しで返されたNextToken値に値を設定します。
MaxResults Integer いいえ 50

返されるエントリの数。

有効な値: 1〜50。 デフォルト値: 20

レスポンスパラメーター

項目 データ型 例: 説明　
RequestId String 6FEA0CF3-D3B9-43E5-A304-D217037876A8

リクエストの ID です。

TotalCount Integer 1

返されたエントリの総数。

NextToken String caeba0bbb2be03f84eb48b699f0a4883

次のクエリの開始点を決定するトークン。 有効な値：

  • NextTokenが返されない場合は、追加の結果が存在しないことを示します。
  • NextTokenが返された場合、値は次のクエリで使用されるトークンです。
MaxResults Integer 20

返されるエントリの最大数。

証明書 証明書の配列

証明書に関する詳細。

CertificateId String 6092 **-cn-hangzhou

証明書の ID 。

IsDefault ブール 真実

証明書がデフォルトであるかどうかを示します。

  • true: デフォルトの証明書
  • false: 追加の証明書
ドメイン String example.com

追加の証明書に関連付けられているドメイン名。

証明書がデフォルトの場合、このパラメーターは返されません。

State String active

証明書の状態。

  • active: 証明書はリスナーに関連付けられ、有効になります。
  • updating: 追加の証明書が置き換え中です。

例

リクエストの例

http(s)://[Endpoint]/?Action=ListListenerCertificates
&RegionId=cn-hangzhou
&AcceleratorId=ga-bp1odcab8tmno0hdq ****
&ロール=デフォルト
&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>
    <証明書>
        <CertificateId>6092 **-cn-hangzhou</CertificateId>
        <IsDefault>true</IsDefault>
        <Domain>example.com</Domain>
        <State>active</State>
    </証明書>
</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、
    "ドメイン" : "example.com" 、
    "状態" : "アクティブ"
  } ]
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。