创建共享带宽
1. 接口描述
调用 CreateBandwidthPackage 接口创建一个共享带宽实例。
- 购买后付费和混合付费的共享带宽时，需保证账户上的可用余额大于1000元。
- 预付费共享带宽的购买会预先扣除本次实例购买所需金额，在调用本次接口前请确保账户余额充足。
- 购买共享带宽需要通过实名认证。您可以参见实名认证相关文档完成认证。
2. 请求参数
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 固定取值：CreateBandwidthPackage |
| RegionCode | String | 是 | 共享带宽所属的地域编码，您可以调用 DescribeRegionConfig 接口获取地域编码 |
| BandwidthProductType | String | 是 | 共享带宽适用的产品类型，您可以调用 DescribeProductConfig 查看您适用的产品类型 |
| BwpLineType | String | 是 | 共享带宽适用的IP线路，您可以调用 DescribeProductConfig 查看您适用IP线路类型 |
| NetworkMode | String | 是 | 网络模式，取值范围： ENETWORK 网络增强型 NORMAL 普通网络型 |
| InternetChargeType | String | 是 | 网络计费方式，取值范围： POST_PAID_MONTH_TRADITION_95 传统95计费 POST_PAID_MONTH_ENHANCE_95 增强95计费 POST_PAID_DAY_MAX 日峰值带宽计费 PRE_PAID_BANDWIDTH_PACKAGE 固定带宽计费 POST_PAID_MONTH_MAX 月峰值带宽计费 注：当付费方式为预付费时，网络计费方式取值只能是按固定带宽计费 |
| GuaranteeBandwidth | String | 是 | 保底带宽值 |
| Period | Integer | 是 | 购买时长 |
| BillingCycle | String | 是 | 计费周期，取值范围： MONTH 月 DAY 日 |
| InstanceChargeType | String | 是 | 付费方式，取值范围： PRE_PAID 预付费 POST_PAID 后付费 HYBRID_PAID 混合付费 |
| AutoRenew | String | 否 | 自动续费状态，取值范围： NONE 不开启自动续费 INFINITE 开启自动续费 |
3. 返回数据
| 名称 | 类型 | 说明 |
|---|---|---|
| RequestId | String | 请求ID |
| BwpUUID | String | 共享带宽唯一标识 |
3. 示例
请求示例
https://openapi.kaopuyun.com/?AccessKeyId=sz0000ei53aw
&Action=CreateBandwidthPackage
&Format=JSON
&SignatureMethod=HMAC-SHA1
&SignatureNonce=76a5d5e7-0992-462d-9a26-916650eca00f
&SignatureVersion=1.0
&Timestamp=2023-03-09T07%3A33%3A56Z
&Version=2014-05-26
&Signature=LH5UYKO7k%2FeQlyLH3p169uyRKyU%3D
&BillingCycle=YEAR
&RegionCode=demo-2
&BandwidthProductType=EIP
&InstanceChargeType=HYBRID_PAID
&BwpLineType=BGP
&Period=1
NetworkMode=NORMAL
&GuaranteeBandwidth=10
&InternetChargeType=POST_PAID_MONTH_ENHANCE_95
正常返回示例
{
"RequestId" : "8a5b4ee0-ebd3-11ed-ab60-1a84ea1e1ce6",
"BwpUUID" : "bwp-rh00000dasv3"
}
4. 错误码
| 错误码 | 错误信息 |
|---|---|
| MissingParameter | RegionCode/BwpLineType/InternetChargeTypeInstanceChargeType 参数不能为空 |
| ValueNotSupported | InternetChargeType/InstanceChargeType/BillingCycle/AutoRenew 参数不合法 |
| AccountBalanceNotEnough | 账户余额不足 |
| AccountNotRealNameAuth | 账户未实名认证 |
| InvalidBwpConfigNotSupported | 共享带宽包配置不合法 |
| CreateBandwidthPackageFail | 创建共享带宽包失败：xxxxx |