HTTPSリスナーの追加の証明書を置き換えます。

説明　

UpdateAdditionalCertificateWithListener操作は、追加の証明書を置き換えるために使用されます。 関連付けられたドメイン名を変更せずに、期限切れの追加証明書を新しい追加証明書に置き換える場合は、この操作を呼び出すことができます。

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

デバッグ

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

リクエストパラメーター

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

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

RegionId String 必須 cn-hangzhou

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

DryRun Boolean いいえ false

リクエストのみを事前チェックするかどうかを指定します。 デフォルト値：false 有効な値：

  • true: この操作を実行せずにリクエストを事前チェックします。 システムは、必要なパラメーター、要求構文、および制限をチェックします。 リクエストが事前チェックに失敗した場合、エラーメッセージが返されます。 リクエストが事前チェックに合格した場合、DryRunOperationエラーコードが返されます。
  • false: リクエストを送信します。 リクエストが事前チェックに合格すると、2xx HTTPステータスコードが返され、操作が実行されます。
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リスナーのみがサポートされています。

ドメイン String 必須 example.com

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

CertificateId String 必須 6092 **-cn-hangzhou

置換証明書のID。

レスポンスパラメーター

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

リージョンのID。

ListenerId String lsr-bp1bpn0kn908w4nbw****

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

例

リクエストの例

http(s)://[Endpoint]/?Action=UpdateAdditionalCertificateWithListener
&RegionId=cn-hangzhou
&DryRun=false
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&AcceleratorId=ga-bp1odcab8tmno0hdq ****
&ListenerId=lsr-bp1bpn0kn908w4nbw ****
&Domai n=example.com
&CertificateId=6092 **-cn-hangzhou
&<共通リクエストパラメーター>

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

XML 形式 

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

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

JSON 形式 

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

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

エラーコード

HttpCode エラーコード エラーメッセージ 説明　
400 NotExist.Accelerator 高速化されたインスタンスは存在しません。 指定されたGAインスタンスが存在しない場合に返されるエラーメッセージ。
400 StateError.Accelerator 高速化されたインスタンスの状態が無効です。 指定されたGAインスタンスが無効な状態の場合に返されるエラーメッセージ。
400 NotExist.Listener リスナーが存在しません。 指定されたリスナーが存在しない場合に返されるエラーメッセージ。
400 NotActive.Listener リスナーの状態がアクティブではありません。 指定されたリスナーが不安定な場合に返されるエラーメッセージ。

エラーコードの一覧については、「サービスエラーコード」をご参照ください。