创建共享流量包
更新时间：2023-08-31
描述
- 共享流量包采用预付费方式，购买共享流量包后立刻生效，并自动抵扣同地域后付费-按流量计费的EIP费用，直到流量包用完或到期为止。
- reservationLength 字段为必填参数，表示共享流量包有效期。填写要求以数字形式，当前有效期支持三种规格：1个月、6个月和12个月。
- capacity 字段为必填参数，表示共享流量包容量。当有效期为1个月时，对应可选规格 "10G"/"50G"/"100G"/"500G"/"1T"/"5T"/"10T"/"50T"；当有效期为6个月时，对应可选规格 "60G"/"300G"/"600G"/"3T"/"6T"/"30T"/"60T"/"300T" ；当有效期为12个月时，对应可选规格 "1T"/"10T"/"50T"/"100T"/"500T"/"1P"，需按照对应可选规格进行容量选择。
- deductPolicy为可选参数，表示共享流量包的扣费策略，包括FullTimeDurationPackage（全时）和TimeDurationPackage（闲时），默认为FullTimeDurationPackage。
- packageType为可选参数，表示共享流量包的线路类型，当前支持 WebOutBytes（动态），默认为WebOutBytes。
请求结构
Plain Text
1POST /v{version}/eiptp?clientToken={clientToken} HTTP/1.1
2Host: eip.bj.baidubce.com
3Authorization: authorization string
4{
5 "reservationLength": reservationLength,
6 "capacity": capacity,
7 "deductPolicy": deductPolicy,
8 "packageType": packageType
9}请求头域
除公共头域外，无其它特殊头域。
请求参数
参数名称 |
类型 |
是否必须 |
参数位置 |
描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值1 |
| clientToken | String | 否 | Query参数 | 幂等性Token |
| reservationLength | int | 是 | RequestBody参数 | 共享流量包有效期（单位：月），1/6/12 |
| capacity | String | 是 | RequestBody参数 | 共享流量包容量 有效期为1时，对应可选规格 "10G"/"50G"/"100G"/"500G"/"1T"/"5T"/"10T"/"50T"； 有效期为6时，对应可选规格 "60G"/"300G"/"600G"/"3T"/"6T"/"30T"/"60T"/"300T"； 有效期为12时，对应可选规格 "1T"/"10T"/"50T"/"100T"/"500T"/"1P"，需按照对应可选规格进行容量选择 |
| deductPolicy | String | 否 | RequestBody参数 | 共享流量包扣费策略，包含 "FullTimeDurationPackage" 全时；"TimeDurationPackage" 闲时，默认为 "FullTimeDurationPackage" |
| packageType | String | 否 | RequestBody参数 | 共享流量包线路类型，当前支持 "WebOutBytes" 动态，默认为 "WebOutBytes" |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域
返回参数
参数名称 |
类型 |
描述 |
|---|---|---|
| id | String | 共享流量包id |
请求示例
Plain Text
1POST /v1/eiptp?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2HOST: eip.bj.baidubce.com
3Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2021-08-17T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
4{
5 "reservationLength": 1,
6 "capacity": "10G",
7 "deductPolicy": "FullTimeDurationPackage",
8 "packageType": "WebOutBytes"
9}响应示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Tue, 17 Aug 2021 08:26:53 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7{
8 "id":"tp-87V5cnkwqO"
9}