文档首页/ 弹性公网IP EIP/ API参考/ API/ 带宽(V2.0)/ 共享带宽移除弹性公网IP
更新时间:2023-12-25 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"
    }

状态码

请参见状态码

错误码

请参考错误码