転送ルータを削除します。
使用上の注意
DeleteTransitRouter は非同期操作です。リクエストを送信した後、リクエスト ID が返されますが、操作はシステム バックグラウンドで引き続き実行されます。ListTransitRouters を呼び出して、転送ルータのステータスをクエリできます。
転送ルータが 削除中 状態の場合、転送ルータは削除されています。この場合、転送ルータをクエリすることはできますが、他の操作を実行することはできません。
転送ルータが見つからない場合、転送ルータは削除されています。
前提条件
転送ルータを削除する前に、以下の前提条件が満たされていることを確認してください。
転送ルータ上にネットワークインスタンス接続が作成されていないこと。
VPC (Virtual Private Cloud) 接続の削除方法の詳細については、「転送ルータ VPC 接続を削除する」をご参照ください。
VBR (仮想ボーダールータ) 接続の削除方法の詳細については、「転送ルータ VBR 接続を削除する」をご参照ください。
CCN (Cloud Connect Network) 接続の削除方法の詳細については、「DetachCenChildInstance」をご参照ください。
VPN 接続の削除方法の詳細については、「転送ルータ VPN 接続を削除する」をご参照ください。
リージョン間接続の削除方法の詳細については、「転送ルータピア接続を削除する」をご参照ください。
転送ルータ上にカスタムルートテーブルが作成されていないこと。カスタムルートテーブルの削除方法の詳細については、「転送ルータルートテーブルを削除する」をご参照ください。
デバッグ
リクエストパラメータ
パラメータ | タイプ | 必須 | 例 | 説明 |
Action | String | Yes | DeleteTransitRouter | 実行する操作。値を DeleteTransitRouter に設定します。 |
ClientToken | String | No | 02fb3da4-130e-11e9-8e44-001**** | リクエストのべき等性を確保するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 ClientToken には ASCII 文字のみを含めることができます。 説明 このパラメータを設定しない場合、ClientToken は RequestId の値に設定されます。RequestId の値は、API リクエストごとに異なる場合があります。 |
DryRun | Boolean | No | false | リクエストの事前チェックのみを行うかどうかを指定します。チェック項目には、権限と転送ルータのステータスが含まれます。有効な値：
|
TransitRouterId | String | Yes | tr-uf654ttymmljlvh2x**** | 転送ルータの ID。 |
レスポンスパラメータ
パラメータ | タイプ | 例 | 説明 |
RequestId | String | 6DE3EE92-39C8-4BBD-A3AD-F568D74741BB | リクエストの ID。 |
例
サンプルリクエスト
http(s)://[Endpoint]/?Action=DeleteTransitRouter
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&DryRun=false
&TransitRouterId=tr-uf654ttymmljlvh2x****
&共通リクエストパラメータサンプルの成功レスポンス
XML 形式
HTTP/1.1 200 OK
Content-Type:application/xml
<DeleteTransitRouterResponse>
<RequestId>6DE3EE92-39C8-4BBD-A3AD-F568D74741BB</RequestId>
</DeleteTransitRouterResponse>JSON 形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "6DE3EE92-39C8-4BBD-A3AD-F568D74741BB"
}エラーコード
HttpCode | エラーコード | エラーメッセージ | 説明 |
400 | OperationFailed.DeleteTransitRouter | Operation failed because TransitRouterRouteEntry exists | 転送ルータにルートエントリが設定されている場合、指定された転送ルータを削除できないために返されるエラーメッセージ。 |
400 | OperationFailed.DeleteTransitRouter | Operation failed because TransitRouterRouteTable exists | カスタムルートテーブルが転送ルータに関連付けられている場合、指定された転送ルータを削除できないために返されるエラーメッセージ。 |
400 | IncorrectStatus.TransitRouterInstance | The status of TransitRouter is incorrect. | 現在の状態では転送ルータを削除できないために返されるエラーメッセージ。 |
400 | OperationFailed.BandwidthLimitExist | Operation is invalid because a bandwidth limit exist. | 転送ルータの帯域幅調整が有効になっている場合、転送ルータを削除できないために返されるエラーメッセージ。 |
エラーコードのリストについては、「API エラーセンター」をご参照ください。