リスナーを削除します。

説明 

  • DeleteListenerは非同期操作です。 リクエストを送信した後、システムはリクエストIDを返しますが、操作はシステムバックグラウンドで実行中です。 DescribeListener操作を呼び出して、リスナーの状態を照会できます。
    • リスナーが削除中の状態の場合は、リスナーが削除中であることを示します。 この場合、クエリ操作のみを実行できます。
    • リスナーを照会できない場合は、リスナーが削除されたことを示します。
  • DeleteListener操作を繰り返し呼び出して、特定の期間内に同じGlobal Accelerator (GA) インスタンスのリスナーを削除することはできません。

デバッグ

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

リクエストパラメーター

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

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

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

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

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

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

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

ListenerId String 必須 lsr-bp1bpn0kn908w4nbw****

削除するリスナーのID。

レスポンスパラメーター

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

リクエストの ID です。

リクエストの例

http(s)://[Endpoint]/?Action=DeleteListener
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&AcceleratorId=ga-bp1odcab8tmno0hdq ****
&ListenerId=lsr-bp1bpn0kn908w4nbw ****
&<共通リクエストパラメーター>

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

XML 形式

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

<DeleteListenerResponse>
    <RequestId>6FEA0CF3-D3B9-43E5-A304-D217037876A8 </RequestId>
</DeleteListenerResponse>

JSON 形式

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

{
  "RequestId" : "6FEA0CF3-D3B9-43E5-A304-D217037876A8\t"
}

エラーコード

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

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