文档首页/ 弹性公网IP EIP/ API参考/ API/ 带宽(V2.0)/ 共享带宽移除弹性公网IP - RemovePublicipsFromSharedBandwidth
更新时间：2025-10-24 GMT+08:00
在线调试
CLI示例
查看PDF
分享

共享带宽移除弹性公网IP - RemovePublicipsFromSharedBandwidth

功能介绍

共享带宽移除弹性公网IP。

接口约束

在共享带宽中批量移除弹性公网IP时，一次可批量操作100个弹性公网IP。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。

授权信息

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

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

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    eip:bandwidths:removePublicIps

    Write

    bandwidth *

    • g:ResourceTag/<tag-key>

    • g:EnterpriseProjectId
    • vpc:publicIps:insert

    -

URI

POST /v2.0/{project_id}/bandwidths/{bandwidth_id}/remove

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取项目ID请参见获取项目ID

bandwidth_id

是

String

带宽唯一标识

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

bandwidth

是

RemoveFromSharedBandwidthOption object

带宽对象
表3 RemoveFromSharedBandwidthOption

参数

是否必选

参数类型

描述

charge_mode

是

String

  • 功能说明：弹性公网IP从共享带宽移除后，会为此弹性公网IP创建独占带宽进行计费。

此参数表示弹性公网IP从共享带宽移除后，使用的独占带宽的计费类型。（bandwidth/traffic）

publicip_info

是

Array of RemovePublicipInfo objects

  • 功能说明：要从共享带宽中移除的弹性公网IP信息

  • 约束：WHOLE类型的带宽支持多个弹性公网IP，跟租户的配额相关，默认一个共享带宽的配额为20

size

是

Integer

  • 功能说明：弹性公网IP从共享带宽移除后，会为此弹性公网IP创建独占带宽进行计费。此参数表示弹性公网IP从共享带宽移除后，使用的独占带宽的带宽大小。单位Mbit/s。

  • 取值范围：默认1Mbit/s~2000Mbit/s（具体范围以各区域配置为准，请参见控制台对应页面显示）。
表4 RemovePublicipInfo

参数

是否必选

参数类型

描述

publicip_type

否

String

  • 功能说明：如果publicip_id为弹性公网IP的id，则该字段可自动忽略。如果publicip_id为IPv6端口PORT的id，则该字段必填：5_dualStack(目前仅北京4局点支持)

最大长度：36

publicip_id

是

String

  • 功能说明：带宽对应的弹性公网IP或IPv6端口PORT的唯一标识

最大长度：36

响应参数

状态码：204

POST操作正常返回

无

请求示例

将id为d91b0028-6f6b-4478-808a-297b75b6812a、1d184b2c-4ec9-49b5-a3f9-27600a76ba3f的弹性公网IP移出按流量计费的共享带宽，支持多个弹性公网IP移除共享带宽。

{
  "bandwidth" : {
    "size" : 22,
    "publicip_info" : [ {
      "publicip_id" : "d91b0028-6f6b-4478-808a-297b75b6812a",
      "publicip_type" : "5_dualStack"
    }, {
      "publicip_id" : "1d184b2c-4ec9-49b5-a3f9-27600a76ba3f"
    } ],
    "charge_mode" : "traffic"
  }
}

响应示例

无

状态码

状态码

描述

204

POST操作正常返回

错误码

请参见错误码。

父主题： 带宽(V2.0)

相关文档