创建带宽包
更新时间：2024-10-14
描述
- 带宽包仅支持绑定预付费资源，目前支持绑定弹性公网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,
"tags":[
{
"tagKey": tagKey,
"tagValue": tagValue
}
],
"resourceGroupId":resourceGroupId
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| 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”） |
| tags | List<TagModel> | 否 | RequestBody参数 | 待创建的标签键值对列表。 |
| resourceGroupId | String | 否 | RequestBody参数 | 创建带宽包的同时绑定的资源分组的ID |
返回状态码
成功返回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,
"tags":[
{
"tagKey": "tagK",
"tagValue": "tagV"
}
],
"resourceGroupId":"RESG-J7PdULjguvB"
}响应示例
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"
}