调用DeleteVpcPeerConnection删除VPC对等连接_专有网络VPC(VPC)-阿里云帮助中心

调用DeleteVpcPeerConnection接口删除VPC对等连接实例。

接口说明

您可用删除 VPC 对等连接实例，删除后，您的业务也会中断，请在不影响业务的情况下执行该操作。
- 如果选择强制删除，系统会将 VPC 路由表中指向 VPC 对等连接实例的路由条目删除。
- 如果未选择强制删除，系统不会将 VPC 路由表中指向 VPC 对等连接实例的路由条目删除，您需要手动删除该路由条目。
DeleteVpcPeerConnection 接口属于异步接口，即系统会先返回一个 RequestId，但该 VPC 对等连接实例并未删除完成，系统后台的删除任务仍在进行。您可以调用 GetVpcPeerConnectionAttribute 查询 VPC 对等连接实例的状态。
- 当 VPC 对等连接实例处于 Deleting 状态时，表示正在删除中。
- 当 VPC 对等连接实例处于 Deleted 状态时，表示删除完成。
DeleteVpcPeerConnection 接口不支持并发删除同一个 VPC 对等连接实例。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作	访问级别	资源类型	条件关键字	关联操作
vpc:DeleteVpcPeerConnection	delete	全部资源 ``	无	无

名称	类型	必填	描述	示例值
InstanceId	string	是	需要删除的 VPC 对等连接的实例 ID。	pcc-lnk0m24khwvtkm****
Force	boolean	否	是否强制删除 VPC 对等连接。取值： false（默认值）：不强制删除 VPC 对等连接。 true：强制删除 VPC 对等连接。强制删除时，系统会将 VPC 路由表中指向该 VPC 对等连接的路由条目删除。	false
DryRun	boolean	否	是否只预检此次请求。取值： true：发送检查请求，不会删除 VPC 对等连接。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码`DryRunOperation`。 false（默认值）：发送正常请求，通过检查后返回 HTTP 2xx 状态码并直接进行操作。	false
ClientToken	string	否	客户端 Token，用于保证请求的幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。说明若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。	02fb3da4-130e-11e9-8e44-001****

名称	类型	描述	示例值
	object	请求 ID。
RequestId	string	请求 ID。	54B48E3D-DF70-471B-AA93-08E683A1B45

正常返回示例

JSON格式

{
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45"
}

HTTP status code	错误码	错误信息	描述
400	ResourceNotFound.InstanceId	The specified resource of %s is not found.	未找到指定实例
400	IncorrectStatus.VpcPeer	The status of %s [%s] is incorrect.	对等连接实例状态不符合要求，该状态下对对连接实例不能被接收。
400	OperationDenied.RouteEntryExist	The operation is not allowed because of existing routeEntry point to VpcPeer.	无法删除VpcPeer，因此存在指向VpcPeer的路由条目

访问错误中心查看更多错误码。

变更时间	变更内容概要	操作
2024-01-23	OpenAPI 描述信息更新、OpenAPI 错误码发生变更	查看变更详情