追加の証明書をHTTPSリスナーに関連付けます。

説明　

  • 追加の証明書をHTTPSリスナーにのみ関連付けることができます。
  • AssociateAdditionalCertificatesWithListenerは非同期操作です。 リクエストを送信した後、システムはリクエストIDを返しますが、操作はシステムバックグラウンドで実行中です。 DescribeListener操作を呼び出して、追加の証明書を関連付けるリスナーの状態を照会できます。
    • リスナーが更新状態にある場合は、追加の証明書が関連付けられていることを示します。 この場合、クエリ操作のみを実行できます。
    • リスナーがアクティブ状態の場合、追加の証明書が関連付けられていることを示します。
  • AssociateAdditionalCertificatesWithListener操作は、特定の期間内に同じGlobal Accelerator (GA) インスタンスに対して繰り返し呼び出すことはできません。

デバッグ

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

リクエストパラメーター

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

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

RegionId String 必須 cn-hangzhou

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

ClientToken String 任意 123e4567-e89b-12d3-a456-426655440000

リクエストのべき等性を保証するために使用されるクライアントトークン。

クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 ClientTokenにはASCII文字のみを含めることができます。

説明 このパラメーターを設定しない場合、ClientTokenはRequestIdの値に設定されます。 RequestIdの値は、APIリクエストごとに異なる場合があります。
AcceleratorId String 必須 ga-bp1odcab8tmno0hdq****

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

ListenerId String 必須 lsr-bp1bpn0kn908w4nbw****

リスナーの ID を示します。 HTTPSリスナーのみがサポートされています。

証明書. N.Id String 必須 6092 **-cn-hangzhou

証明書の ID 。 サーバー証明書のみがサポートされています。

各リクエストで最大10の証明書IDを指定できます。

証明書N. ドメイン String 必須 example.com

証明書で指定されたドメイン名。

各ドメイン名を1つの追加証明書にのみ関連付けることができます。

各リクエストで最大10個のドメイン名を指定できます。

レスポンスパラメーター

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

リクエストの ID です。

ListenerId String lsr-bp1bpn0kn908w4nbw****

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

例

リクエストの例

http(s)://[Endpoint]/?Action=AssociateAdditionalCertificatesWithListener
&RegionId=cn-hangzhou
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&AcceleratorId=ga-bp1odcab8tmno0hdq ****
&ListenerId=lsr-bp1bpn0kn908w4nbw ****
&Certificates=[{"Id":"6092**-cn-hangzhou "," Domain ":" example.com "}]
&共通リクエストパラメータ

正常に処理された場合のレスポンス例

XML 形式 

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

<AssociateAdditionalCertificatesWithListenerResponse>
    <RequestId>6FEA0CF3-D3B9-43E5-A304-D217037876A8</RequestId>
    <ListenerId>lsr-bp1bpn0kn908w4nbw ****</ListenerId>
</AssociateAdditionalCertificatesWithListenerResponse>

JSON 形式 

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

{
  "RequestId" : "6FEA0CF3-D3B9-43E5-A304-D217037876A8" 、
  "ListenerId" : "lsr-bp1bpn0kn908w4nbw ****"
}

エラーコード

HttpCode エラーコード エラーメッセージ 説明　
400 ProtocalIllegal.Listener 指定されたリスナープロトコルは無効です。 リスナープロトコルが無効な場合に返されるエラーメッセージ。
400 NotExist.Accelerator 高速化されたインスタンスは存在しません。 指定されたGAインスタンスが存在しない場合に返されるエラーメッセージ。
400 QuotaExceeded.Listener リスナーの最大数を超えています。 リスナーの数が上限に達した場合に返されるエラーメッセージ。
400 PortRangeIllegal. リスナー 指定されたリスナーポート範囲は無効です。 リスナーのポート範囲が無効な場合に返されるエラーメッセージ。
400 PortConflict.Listener リスナーポートの設定が競合しています。 指定されたリスナーポートの構成が別のリスナーポートの構成と競合する場合に返されるエラーメッセージ。
400 QuotaExceeded.ListenerPort リスナーポートの最大数を超えています。 リスナーポートの数が上限に達した場合に返されるエラーメッセージ。
400 PortRangeIllegal.ExceedGaAbility リスナーポート範囲が無効です。 アクセラレータインスタンスごとに、プロトコル (TCPおよびUDP) ごとに300を超えるポート範囲を持つリスナーのみを作成できます。 リスナーのポート範囲が無効な場合に返されるエラーメッセージ。 GAインスタンスごとに、1つのTCPリスナーと1つのUDPリスナーのみを作成でき、連続するポートの範囲は300を超えます。
400 PortRangeIllegal.UDP UDPポート250、4789、4790はシステム予約ポートです。 UDPリスナーにポート250、4789、および4790を指定できない場合に返されるエラーメッセージ。 これらのポートは、システムによって予約される。
400 SystemPort.Listener ポート65500〜65535は、システム予約ポートである。 65535 65500のポートがシステムによって予約されている場合に返されるエラーメッセージ。
400 PortRanges.MustOne portRangesはHTTPSとHTTPタイプのリスナーの1つである必要があります。 HTTPまたはHTTPSリスナーが1つのポートのみをサポートしている場合に返されるエラーメッセージ。

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