变更共享带宽配置
1. 接口说明
调用 UpGradeBandwidthPackageSpec 或 DownGradeBandwidthPackageSpec 接口变更共享带宽保底带宽。
- 升级混合付费共享带宽的保底带宽，系统会预先扣除本次实例升级所需金额，请确保账户余额充足。
- 共享带宽状态必须为 AVAILABLE 时才能变更带宽。
- 已欠费的共享带宽不允许变更保底带宽。
2. 请求参数
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 固定取值：UpGradeBandwidthPackageSpec 或 DownGradeBandwidthPackageSpec 注意：升级保底带宽固定取值UpGradeBandwidthPackageSpec ； 降级保底带宽固定取值DownGradeBandwidthPackageSpec |
| BwpUUID | String | 是 | 共享带宽唯一标识 |
| GuaranteeBandwidth | Integer | 是 | 保底带控制，单位：Mbps 取值范围，您可以调用 DescribeProductConfig 查看指定地域下的共享带宽保底取值范围 |
| InstanceChargeType | String | 是 | 付费方式，取值范围： PRE_PAID 预付费 POST_PAID 后付费 HYBRID_PAID 混合付费 |
| 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 月峰值带宽计费 |
| ClientToken | String | 是 | 用于保证请求的幂等性 |
3. 返回数据
| 名称 | 类型 | 描述 |
|---|---|---|
| RequestId | String | 请求ID |
4. 示例
请求示例
https://openapi.kaopuyun.com/?AccessKeyId=sz0000ei53aw
&Action=UpGradeBandwidthPackageSpec
&Format=JSON
&BwpUUID=bwp-rh00000das8i
&GuaranteeBandwidth=50
&InstanceChargeType=PRE_PAID
&InternetChargeType=PRE_PAID_BANDWIDTH_PACKAGE
&ClientToken=76a5d5e7-0992-462d-9a26-916650eca00f
&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
正常返回示例
{
"RequestId" : "8a5b4ee0-ebd3-11ed-ab60-1a84ea1e1ce6"
}
5. 错误码
| 错误码 | 错误信息 |
|---|---|
| MissingParameter | BwpUUID 参数不能为空 |
| AvailableBwpNotFound | 指定的共享带宽不存在 |
| ValueNotSupported | InstanceChargeType参数不合法 |
| IncorrectBwpStatus | 指定的共享带宽包状态不支持此操作 |
| InvalidBwpConfigNotSupported | 共享带宽包配置不合法 |
| IncorrectBwpInstanceChargeType | 指定共享带宽包的付费方式不支持此操作 |
| ResourceOwnerIdError | 资源所属用户错误 |
| UpGradeBandwidthPackageSpecFail / DownGradeBandwidthPackageSpecFail | 共享带宽包变更保底带宽失败：xxxxx |