创建带宽包
所有文档

          弹性公网IP EIP

          创建带宽包

          描述

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

          请求结构

          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,
              "type":type,
              "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参数 带宽包的公网带宽
          type String RequestBody参数 带宽包的类型,包括BandwidthPackage(带宽包)和AccelerationPackage(跨境加速包),其中跨境加速包仅支持中国香港区域,默认为BandwidthPackage
          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"
          }
          上一篇
          共享带宽相关接口
          下一篇
          调整带宽包带宽