文档首页/ 虚拟专用网络 VPN/ API参考/ API/ 站点入云VPN API/ 站点入云VPN网关/ 公网IP解绑实例 - DisassociateInstance
更新时间：2026-09-29 GMT+08:00
查看PDF
分享

公网IP解绑实例 - DisassociateInstance

功能介绍

根据EIPID和网关ID，解绑指定的网关的EIP。

调用方法

请参见3-如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

vpn:vpnGateways:disassociateInstance

write

vpnGateways

-
  • vpn:vpnGateways:get
  • vpn:vpnConnections:list
  • eip:publicIps:disassociateInstance

URI

POST /v5/{project_id}/vpn-gateways/{vpn_gateway_id}/disassociate-instance

表1 请求path参数列表

名称

类型

描述

project_id

String

项目ID，可以通过获取项目ID获取项目ID。

vpn_gateway_id

String

VPN网关实例ID。

请求消息

  • 请求参数
    表2 请求参数

    名称

    类型

    描述

    publicip_id

    String

    公网IP的ID。
  • 请求样例 
    POST https://{Endpoint}/v5/{project_id}/vpn-gateways/{vpn_gateway_id}/disassociate-instance
{
" publicip_id": " 2d1da07b-861d-447d-8233-1aff4d767825"
}

响应消息

  • 响应参数
    返回状态码为 200: successful operation。
    表3 响应Body参数列表

    名称

    类型

    描述

    publicip

    表4 PublicipResp object

    公网IP对象。

    request_id

    String

    请求id。
    表4 PublicipResp

    名称

    类型

    描述

    publicip

    PublicipResp object

    公网IP对象。
  • 响应样例 
    {
"publicip": {
"id": "267bcfb9-3bd8-4fd9-83f4-aa6960d0f4c4",
"project_id": "4719047425034edc848b98781092d16c",
"ip_version": 4,
"public_ip_address": "215.255.3.116",
"status": "DOWN",
"description": "VPN CREATE EIP",
"created_at": "2026-08-04T12:23:02Z",
"updated_at": "2026-08-07T10:08:19Z",
"type": "EIP",
"bandwidth": {
"id": "0a5022a3-d9a5-47be-933c-41f3b6709baa",
"size": 5,
"share_type": "WHOLE",
"charge_mode": "primary_traffic",
"name": "bandwidth-49cf",
"billing_info": ""
},
"enterprise_project_id": "0",
"publicip_pool_id": "f0ff757a-af88-47ac-92bf-9c78b38ab9d4",
"publicip_pool_name": "5_shctbgp",
"public_border_group": "center",
"tags": []
},
"request_id": "4f312608282c8cf9ebebae80d38d3d71"
}

状态码

请参见状态码。

父主题： 站点入云VPN网关

相关文档