
# 二层连接解绑虚拟IP - UnbindVport
#### 功能介绍
当您的二层连接已经绑定虚拟IP时，您可以通过调用此接口将虚拟IP与二层连接解绑。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/esw/doc?api=UnbindVport&version=v2)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-esw/esw_api0011.html)。
| 授权项                        | 访问级别  | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 |
|:---|:---|:---|:---|:---|:---|
| esw:connection:unbindVport | Write | -           | -   | -  | -      |
   
#### URI
POST /v3/{project_id}/l2cg/connections/{connection_id}/vports/unbind
表1路径参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                            |
|:---|:---|:---|:---|
| connection_id | 是    | String | - 参数解释：二层连接的唯一标识。 - 约束限制：带"-"的UUID格式。 - 取值范围：不涉及。 - 默认取值：不涉及。 |
| project_id    | 是    | String | - 参数解释：ESW实例所属项目ID。 - 约束限制：不涉及。 - 取值范围：不涉及。 - 默认取值：不涉及。       |
#### 请求参数
表2请求Body参数 
| 参数    | 是否必选 | 参数类型                                        | 描述                                                      |
|:---|:---|:---|:---|
| vport | 是    | [Vport] object | - 参数解释：解绑vport的请求体。 - 约束限制：不涉及。 - 取值范围：不涉及。 - 默认取值：不涉及。 |
   
 表3Vport 
| 参数 | 是否必选 | 参数类型   | 描述                                                                      |
|:---|:---|:---|:---|
| id | 是    | String | - 参数解释：虚拟IP地址的唯一标识。 - 约束限制：需保证该ID对应资源是当前租户可操作的。 - 取值范围：不涉及。 - 默认取值：不涉及。 |
   
#### 响应参数
**状态码：204**
POST操作正常返回，更多状态码请参见[状态码](https://support.huaweicloud.com/api-esw/esw_api0020.html)。
无
#### 请求示例
```
POST https://{endpoint}/v3/05137572fa00d5eb2fdcc014b0f5c751/l2cg/connections/6a9c6b1a-0d5c-495a-8e0c-4f631bde397f/vports/unbind
{
  "vport" : {
    "id" : "84beed10-ef3e-42a8-902c-9d6cdc0d4e20"
  }
}
```
#### 响应示例
无
#### 状态码
| 状态码 | 描述                                                                                  |
|:---|:---|
| 204 | POST操作正常返回，更多状态码请参见[状态码](https://support.huaweicloud.com/api-esw/esw_api0020.html)。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-esw/ErrorCode.html)。
