创建共享流量包
更新时间：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。
请求结构
POST /v{version}/eiptp?clientToken={clientToken} HTTP/1.1
Host: eip.bj.baidubce.com
Authorization: authorization string
{
"reservationLength": reservationLength,
"capacity": capacity,
"deductPolicy": deductPolicy,
"packageType": packageType
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| 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 |
请求示例
POST /v1/eiptp?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
HOST: eip.bj.baidubce.com
Authorization: bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2021-08-17T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
{
"reservationLength": 1,
"capacity": "10G",
"deductPolicy": "FullTimeDurationPackage",
"packageType": "WebOutBytes"
}响应示例
HTTP/1.1 200 OK
x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
Date: Tue, 17 Aug 2021 08:26:53 GMT
Transfer-Encoding: chunked
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"id":"tp-87V5cnkwqO"
}