调用DeleteVSwitch接口删除交换机。

接口说明

调用该接口删除交换机时，请注意以下事项：

  • 删除交换机之前，需要先释放或移走VPC内的所有资源，包括交换机、云产品实例、路由器接口、HaVip等。
  • 只有处于Available状态的交换机可以被删除。
  • 交换机所在的VPC正在创建或删除交换机或路由条目时，无法删除交换机。
  • DeleteVSwitch接口属于异步接口，即系统会返回一个请求ID，但该交换机尚未删除成功，系统后台的删除任务仍在进行。您可以调用DescribeVSwitchAttributes查询交换机的删除状态：
    • 当交换机处于Deleting状态时，表示交换机正在删除中。
    • 当查询不到指定的交换机时，表示交换机删除成功。
  • DeleteVSwitch接口不支持并发删除同一个交换机。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DeleteVSwitch

系统规定参数。取值：DeleteVSwitch。

VSwitchId String 是 vsw-asdfjlna****

要删除的交换机的ID。

RegionId String 否 cn-hangzhou

要删除的交换机的地域ID。

返回数据

名称 类型 示例值 描述
RequestId String 0ED8D006-F706-4D23-88ED-E11ED28DCAC0

请求ID。

示例

请求示例

http(s)://vpc.aliyuncs.com/?Action=DeleteVSwitch
&VSwitchId=vsw-asdfjlna****
&<公共请求参数>

正常返回示例

XML格式 

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

<DeleteVSwitchResponse>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</DeleteVSwitchResponse>

JSON格式 

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

{
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

错误码

HttpCode 错误码 错误信息 描述
400 IncorrectVSwitchStatus The current virtual switch status does not support this operation. 该vSwitch处于pending状态，无法删除。
400 DependencyViolation Specified object has dependent resources. 该交换机下还有资源未释放，无法删除，请释放该VPC下的云产品资源后再删除VPC。
400 DependencyViolation Some route entry status blocked this operation. 无法执行该操作，当前路由表中有路由条目的状态为pending或modifying。
400 IncorrectRouteEntryStatus Some route entry status blocked this operation. 无法执行该操作，当前路由表中有路由条目的状态为pending或modifying。
400 DependencyViolation.HaVip VSwitch cannot be deleted when there are some HaVip dependent with it. 无法删除交换机，该交换机下有关联的HaVip。
400 MissingParameter Miss mandatory parameter. 缺少必要参数，请您检查必填参数是否都已填后再进行操作。
404 InvalidVSwitchId.NotFound VSwitch not exist. 该交换机不存在，请您检查输入的交换机是否正确。
404 IncorrectStatus Vswtich status not stable. 当前交换机的状态为pending或modifying，请您稍后再试。

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