DeleteTransitRouterVpcAttachment - - Alibaba Cloud ドキュメントセンター

Enterprise Edition 転送ルーターから仮想プライベートクラウド (VPC) 接続を削除します。

操作説明

DeleteTransitRouterVpcAttachment は非同期操作です。リクエストを送信すると、システムは リクエスト ID を返し、バックグラウンドでタスクを実行します。 ListTransitRouterVpcAttachments 操作を呼び出して、VPC 接続のステータスをクエリできます。

VPC 接続が Detaching 状態の場合、VPC 接続は削除中です。 VPC 接続をクエリすることはできますが、他の操作は実行できません。
VPC 接続が見つからない場合は、削除されています。

前提条件

VPC 接続を削除する前に、以下の要件が満たされていることを確認してください。

VPC 接続と Enterprise Edition 転送ルーターのルートテーブル間に、関連付けられた転送相関が確立されていません。関連付けられた転送相関を削除する方法の詳細については、「転送ルーターの接続をルートテーブルから関連付け解除する」をご参照ください。
VPC 接続と Enterprise Edition 転送ルーターのルートテーブル間に、ルート学習相関が確立されていません。ルート学習相関を削除する方法の詳細については、「転送ルーターのルートテーブルの伝播を無効にする」をご参照ください。
VPC のルートテーブルに、VPC 接続を指すルートが含まれていません。 VPC ルートテーブルからルートを削除する方法の詳細については、「ルートエントリを削除する」をご参照ください。
Enterprise Edition 転送ルーターのルートテーブルに、ネクストホップがネットワークインスタンス接続であるカスタムルートエントリが含まれていません。 Enterprise Edition 転送ルーターのルートテーブルからカスタムルートを削除する方法の詳細については、「転送ルーターのルートエントリを削除する」をご参照ください。
Enterprise Edition 転送ルーターのルートテーブルに、プレフィックスリストから生成されたルートが含まれておらず、ネクストホップが VPC 接続です。ルートテーブルをプレフィックスリストから関連付け解除することで、このようなルートを削除できます。詳細については、「転送ルーターのプレフィックスリストの関連付けを削除する」をご参照ください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

cen:DeleteTransitRouterVpcAttachment

delete

*TransitRouterVpcAttachment

acs:cen:*:{#accountId}:centransitrouterattachment/{#centransitrouterattachmentId}

なし

リクエストパラメーター

パラメーター	タイプ	必須 / 任意	説明	例
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、すべてのリクエストでトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができます。説明このパラメーターを設定しない場合、ClientToken は RequestId の値に設定されます。 API リクエストごとに RequestId の値が異なる場合があります。	02fb3da4-130e-11e9-8e44-001****
TransitRouterAttachmentId	string	必須	VPC 接続の ID。	tr-attach-ia340z7xis7t5s****
DryRun	boolean	任意	ドライランを実行するかどうかを指定します。デフォルト値： false (デフォルト): ドライランを実行し、リクエストを送信します。 true: ドライランを実行します。システムは必須パラメーターとリクエスト構文をチェックします。リクエストがドライランに失敗した場合、エラーメッセージが返されます。リクエストがドライランに合格した場合、システムはリクエストの ID を返します。	false
Force	boolean	任意	VPC 接続を強制的に削除するかどうかを指定します。有効な値： false (デフォルト): 削除前に、VPC 接続に関連する転送の関連付けやルート学習ポリシーなどのリソースを確認します。このようなリソースが存在する場合、VPC 接続は削除されず、エラーメッセージが返されます。 true: VPC 接続と、VPC 接続に関連付けられているすべてのリソースを削除します。	false

レスポンスパラメーター

パラメーター	タイプ	説明	例
	object	レスポンス。
RequestId	string	リクエストの ID。	7E61D334-4025-41EF-9145-FC327B35301D

例

成功レスポンス

JSONJSON

{
  "RequestId": "7E61D334-4025-41EF-9145-FC327B35301D"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	OperationFailed.AttachmentReferencedVpcRouteEntryExisted	Operation is failed because there is at least one route entry which next hop is the specified attachment.
400	OperationFailed.RouteTablePropagationExist	The specified TransitRouterAttachment has configured RouteTablePropagation. Please remove the configuration first.
400	OperationFailed.MulticastDomainAssociationExist	The specified TransitRouterAttachment has configured MulticastDomainAssociation. Please remove the configuration first.
400	OperationUnsupported.TransitRouterType	The specified TransitRouterType does not support the operation.
400	OperationFailed.PrefixListExist	Operation failed because PrefixList exists.
400	InvalidTransitRouterAttachmentId.NotFound	TransitRouterAttachmentId is not found.
400	IncorrectStatus.VpcRouteEntry	The resource is not in a valid state for the attachment operation.
400	IncorrectStatus.VpcSwitch	The resource is not in a valid state for the attachment operation.
400	IncorrectStatus.Vpc	The resource is not in a valid state for the operation.
400	OperationFailed.NotSupportForceDelete	Not support force delete attachment.
400	IncorrectStatus.VpcRouteTable	The VPC route table is not in a desired state.
400	OperationFailed.RouteEntryExist	Failed to delete the instance because a route table entry points to the instance.
400	OperationFailed.RouteTableAssociationExist	Operation failed because there is associated routing table.
400	IncorrectStatus.VpcResource	The resource is not in a valid state for the attachment operation.
400	OperationFailed.FlowLogExistOrNisOpened	Operation failed because FlowLog exists or Nis opened.
400	InvalidParameter	Invalid parameter.
400	Unauthorized	The AccessKeyId is unauthorized.
400	OperationNotPermitted.AttachmentManagedByCloudService	The specified Attachment managed by cloud service can only be deleted through cloud service.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。