解绑全域公网带宽 - DetachInternetBandwidth

功能介绍

解绑全域公网带宽。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

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

如果使用角色与策略授权，具体权限要求请参见权限和授权项。

如果使用身份策略授权，需具备如下身份策略权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
eip:globalEips:detachBandwidth	Write	globalEip *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	eip:globalEips:remove	-
eip:globalEips:detachBandwidth	Write	internetBandwidth *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	eip:globalEips:remove	-

URI

POST /v3/{domain_id}/global-eips/{global_eip_id}/detach-internet-bandwidth

表1 路径参数
参数	是否必选	参数类型	描述
domain_id	是	String	租户账号ID，获取租户账号ID请参见租户账号ID 最小长度：5 最大长度：32
global_eip_id	是	String	global_eip_id 最小长度：36 最大长度：36

表2 Query参数
参数	是否必选	参数类型	描述
force_unbind	否	Boolean	是否强制解绑

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户的Token，获取用户Token请参见获取用户Token

响应参数

状态码：200

表4 响应Header参数
参数	参数类型	描述
X-Request-Id	String	本次请求编号

请求示例

解绑id为dad6a045-c939-456c-92f2-3c41b0750260全域弹性公网IP的全域公网带宽

POST https://{Endpoint}/v3/{domain_id}/global-eips/dad6a045-c939-456c-92f2-3c41b0750260/detach-internet-bandwidth

响应示例

状态码：200

{
  "example" : {
    "global_eip" : {
      "enterprise_project_id" : 0,
      "name" : "geip-981s-0002",
      "created_at" : "2023-12-12T07:53:59Z",
      "updated_at" : "2023-12-12T08:07:01Z",
      "id" : "dad6a045-c939-456c-92f2-3c41b0750260",
      "description" : null,
      "domain_id" : "f35feb8670a94a04a08d6628e0d5165b",
      "access_site" : "cn-south-odin",
      "geip_pool_name" : "cn-south-odin",
      "isp" : "BGP",
      "ip_version" : 4,
      "freezen" : false,
      "status" : "idle",
      "freezen_info" : null,
      "is_pre_paid" : false,
      "tags" : [ ],
      "ip_address" : "10.83.68.72",
      "ipv6_address" : null,
      "polluted" : false,
      "internet_bandwidth_info" : null,
      "global_connection_bandwidth_info" : null,
      "associate_instance_info" : null
    },
    "request_id" : "2fee4b49a8fb7b93ed419b9ba7433354"
  },
  "schema" : {
    "$ref" : "#/components/schemas/DetachInternetBandwidthGlobalEipsResponseBody"
  }
}