创建流量突发服务包
更新时间:2022-05-16
描述
- 流量突发服务包采用预付费方式,购买后立刻生效。
- 创建流量突发服务包时,有关购买时长,续费时长字段,取值都必须为整数。
- 创建流量突发服务包时,若需要自动续费,需同时指定autoRenewTime和autoRenewTimeUnit参数,缺任何一个都认为不开启自动续费服务。
请求结构
POST /v{version}/tbsp?clientToken={clientToken} HTTP/1.1
Host: eip.bj.baidubce.com
Authorization: authorization string
{
"name": name,
"lineType": lineType,
"ipCapacity": ipCapacity,
"reservationLength": reservationLength,
"reservationTimeUnit": reservationTimeUnit,
"autoRenewTime": autoRenewTime,
"autoRenewTimeUnit": autoRenewTimeUnit
}
请求头域
除了公共头域外,无其他特殊头域
请求参数
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
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 |
请求示例
POST /v1/tbsp?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
Host: eip.bj.baidubce.com
Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2021-11-06T12:28:04Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf16
{
"name": "tbsp",
"ipCapacity": 1,
"lineType": "BGP_S",
"reservationLength": 3,
"reservationTimeUnit": "MONTH",
"autoRenewTime": 1,
"autoRenewTimeUnit": "MONTH"
}
返回示例
HTTP/1.1 200 OK
Server: nginx/1.19.0
Date: Sat, 06 Nov 2021 12:28:05 GMT
Content-Type: application/json; charset=UTF-8
X-Bce-Request-Id: e63d384a-6d74-49f3-8364-50db7f7c56f2
{
"id": "ipDdos-82562e17"
}