文档首页/ 弹性公网IP EIP/ API参考/ API/ 带宽(V2.0)/ 共享带宽移除弹性公网IP
更新时间:2026-11-13 GMT+08:00

共享带宽移除弹性公网IP

功能介绍

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

URI

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

参数说明请参见表1。
表1 参数说明

名称

是否必选

说明

project_id

是

项目ID,获取项目ID请参见获取项目ID。

bandwidth_id

是

带宽唯一标识

请求参数

表2 请求参数

名称

是否必选

参数类型

说明

bandwidth

是

bandwidth object

带宽对象,请参见表3。

表3 bandwidth字段说明

名称

是否必选

参数类型

说明

publicip_info

是

Array of publicip_info objects

  • 功能说明:要从共享带宽中移除的弹性公网IP信息,请参见表4。
  • 约束:WHOLE类型的带宽支持多个弹性公网IP,跟租户的配额相关,默认一个共享带宽的配额为20。

charge_mode

是

String

弹性公网IP从共享带宽移除后,会为此弹性公网IP创建独占带宽进行计费。

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

(bandwidth/traffic)

size

是

Integer

弹性公网IP从共享带宽移除后,会为此弹性公网IP创建独占带宽进行计费。

此参数表示弹性公网IP从共享带宽移除后,使用的独占带宽的带宽大小。(M)

取值范围:默认为1Mbit/s~300Mbit/s(具体范围以各区域配置为准,请参见控制台对应页面显示)。

表4 publicip_info对象

名称

是否必选

参数类型

说明

publicip_id

是

String

带宽对应的弹性公网IP的唯一标识

publicip_type

否

String

若publicip_id为弹性公网IP的id,则该字段会自动忽略。若publicip_id为IPv6端口的id,则该字段必填5_dualStack(目前仅华北-北京四支持)。

请求样例

POST https://{Endpoint}/v2.0/{project_id}/bandwidths/{bandwidth_id}/remove

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

响应参数

无

响应样例

无

或

{
       "code":"xxx",
       "message":"xxxxx"
}

状态码

请参见状态码。

错误码

请参考错误码。