创建流量突发服务包
更新时间:2022-05-16
描述
- 流量突发服务包采用预付费方式,购买后立刻生效。
- 创建流量突发服务包时,有关购买时长,续费时长字段,取值都必须为整数。
- 创建流量突发服务包时,若需要自动续费,需同时指定autoRenewTime和autoRenewTimeUnit参数,缺任何一个都认为不开启自动续费服务。
请求结构
Plain Text
1POST /v{version}/tbsp?clientToken={clientToken} HTTP/1.1
2Host: eip.bj.baidubce.com
3Authorization: authorization string
4{
5 "name": name,
6 "lineType": lineType,
7 "ipCapacity": ipCapacity,
8 "reservationLength": reservationLength,
9 "reservationTimeUnit": reservationTimeUnit,
10 "autoRenewTime": autoRenewTime,
11 "autoRenewTimeUnit": autoRenewTimeUnit
12}
请求头域
除了公共头域外,无其他特殊头域
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
version | String | 是 | URL参数 | API版本号,当前取值1 |
clientToken | String | 是 | Query参数 | 幂等性Token,详见幂等性。 |
name | String | 是 | RequestBody参数 | 流量突发服务包名称 |
lineType | String | 是 | RequestBody参数 | 线路类型(支持BGP/BGP_S,分别代表标准BGP/增强BGP) |
ipCapacity | Int | 是 | RequestBody参数 | 单个服务包的IP容量(1/5/30/100) |
reservationLength | Int | 是 | RequestBody参数 | 购买时长(按天:1-20;按月:3,6; 按年:1-3) |
reservationTimeUnit | String | 是 | RequestBody参数 | 购买时长单位(DAY/MONTH/YEAR) |
autoRenewTime | Int | 否 | RequestBody参数 | 自动续费周期,创建TBSP同时开通自动续费(按月:1-9; 按年:1-3) |
autoRenewTimeUnit | String | 否 | RequestBody参数 | 自动续费周期单位,创建TBSP同时开通自动续费(MONTH/YEAR) |
返回状态码
成功返回200,失败返回见错误码。
返回头域
除公共头域外,无其他特殊头域
返回参数
参数名称 | 类型 | 描述 |
---|---|---|
id | String | 流量突发服务包id |
请求示例
Java
1POST /v1/tbsp?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2Host: eip.bj.baidubce.com
3Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2021-11-06T12:28:04Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf16
4
5{
6 "name": "tbsp",
7 "ipCapacity": 1,
8 "lineType": "BGP_S",
9 "reservationLength": 3,
10 "reservationTimeUnit": "MONTH",
11 "autoRenewTime": 1,
12 "autoRenewTimeUnit": "MONTH"
13}
返回示例
Java
1HTTP/1.1 200 OK
2Server: nginx/1.19.0
3Date: Sat, 06 Nov 2021 12:28:05 GMT
4Content-Type: application/json; charset=UTF-8
5X-Bce-Request-Id: e63d384a-6d74-49f3-8364-50db7f7c56f2
6
7{
8 "id": "ipDdos-82562e17"
9}