弹性公网IPEIP

    创建带宽包

    描述

    • 带宽包仅支持绑定预付费资源,目前支持绑定弹性公网Eip和共享带宽。
    • name字段为可选参数,表示带宽包名称,不填写则自动生成。若填写要求以字母开头,只能包括数字、字母、及- _ . /中的特殊字符,长度不超过65个字符。
    • eip 和 eipGroup 字段分别表示待绑定资源的 Eip 的IP地址或共享带宽的 id,只能有一个字段生效,若都填写则仅有"eip"字段生效。
    • eip 只能是单独弹性公网实例的IP地址,不能是属于某个共享带宽资源的IP地址。
    • bandwidthInMbps字段表示带宽包的公网带宽,要求为大于0的整数,且该值与所绑定资源的带宽总和不大于200Mbps。
    • autoReleaseTime为可选参数,表示带宽包自动释放时间。如果设置要求时间格式符合UTC格式(格式形如:”2019-08-03T20:38:43Z”),该时间要介于当前时间和所绑定的预付费实例的到期时间之间,若不填写则随所绑定资源的到期一并释放。

    请求结构

    POST /v{version}/eipbp?clientToken={clientToken} HTTP/1.1  
    Host: eip.bj.baidubce.com      
    Authorization: authorization string
    {
    	"name": name,
    	"eip": eip,
    	"eipGroupId": eipGroupId,
    	"bandwidthInMbps": bandwidthInMbps,
        "autoReleaseTime":autoReleaseTime
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必须 参数位置 描述
    version String URL参数 API版本号,当前取值1
    clientToken String Query参数 幂等性Token
    name String RequestBody参数 带宽包名称,不填将自动生成
    eip String RequestBody参数 带宽包绑定的弹性公网EIP的Ip地址
    eipGroupId String RequestBody参数 带宽包绑定的共享带宽id
    bandwidthInMbps int RequestBody参数 带宽包的公网带宽
    autoReleaseTime String RequestBody参数 带宽包自动释放时间,时间格式要求符合UTC格式(格式形如:”2019-08-03T20:38:43Z”)

    返回状态码

    成功返回200,失败返回见错误码

    返回头域

    除公共头域外,无其他特殊头域

    返回参数

    参数名称 类型 描述
    id String 带宽包id

    请求示例

    POST /v1/eipbp?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
    HOST: eip.bj.baidubce.com
    Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
    {
        "name":"bp-for-test",
        "eip": "10.23.42.12",
        "bandwidthInMbps": 5
    }

    响应示例

    HTTP/1.1 200 OK
    x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
    Date: Wed, 10 Apr 2016 08:26:52 GMT
    Transfer-Encoding: chunked
    Content-Type: application/json;charset=UTF-8
    Server: BWS
    {
        "id":"bw-2ede9df3"
    }
    上一篇
    共享带宽相关接口
    下一篇
    调整带宽包带宽