按需转包年/包月带宽
功能介绍
该接口用于将带宽的计费模式从按需转为包年/包月。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。
URI
POST /v2.0/{project_id}/bandwidths/change-to-period
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取项目ID请参见获取项目ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
bandwidth_ids |
是 |
Array of strings |
待按需转包带宽列表 |
extendParam |
是 |
按需转包周期参数 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
charge_mode |
是 |
String |
|
period_type |
是 |
String |
|
period_num |
是 |
Integer |
最小值:1 最大值:9 |
is_auto_renew |
否 |
Boolean |
false:不自动续订 true:自动续订 缺省值:false |
is_auto_pay |
否 |
Boolean |
缺省值:false |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
bandwidth_ids |
Array of strings |
转包带宽列表 |
order_id |
String |
订单ID |
request_id |
String |
请求ID |
请求示例
将ID为fe2a11c7-c880-49f7-b1e0-e151df2cc836的按需带宽转为包周期带宽,订购周期为1个月,不自动续费。
POST /v2.0/{project_id}/bandwidths/change-to-period { "bandwidth_ids" : [ "fe2a11c7-c880-49f7-b1e0-e151df2cc836" ], "extendParam" : { "charge_mode" : "prePaid", "period_type" : "month", "period_num" : 1, "is_auto_renew" : false, "is_auto_pay" : true } }
响应示例
状态码:200
按需转包正常返回
{ "bandwidth_ids" : [ "fe2a11c7-c880-49f7-b1e0-e151df2cc836" ], "order_id" : "CS2212141741L0QZG", "request_id" : "8bcadb5d-1bf4-42e8-909f-1606ecf781ce" }
状态码
状态码 |
描述 |
---|---|
200 |
按需转包正常返回 |
错误码
请参见错误码。