华为云计算 云知识 按需转包APIChangeBandwidthToPeriod
按需转包APIChangeBandwidthToPeriod

 

功能介绍

该接口用于将按需计费模式的带宽转为包年/包月计费模式的带宽。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v2.0/{project_id}/bandwidths/change-to-period

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

bandwidth_ids

Array

待按需转包带宽列表

extendParam

CreatePrePaidPublicipExtendParamOption object

按需转包周期参数

表3 CreatePrePaidPublicipExtendParamOption

参数

是否必选

参数类型

描述

charge_mode

String

  • 功能说明:付费方式(预付费、按需付费;预付费,即包周期付费)

  • 取值范围:

    • prePaid -预付费,即包年包月;

    • postPaid-后付费,即按需付费;

  • 后付费的场景下,extendParam的其他字段都会被忽略。

缺省值:postPaid

枚举值:

  • prePaid

  • postPaid

period_type

String

  • 功能说明:订购资源的周期类型(包年、包月等)

  • 取值范围:

    • month-月

    • year-年

  • 约束:如果用包周期共享带宽创建时(即携带共享带宽id创建EIP)此字段可不填。付费方式是预付费且不是使用共享带宽创建IP时,该字段必选; 使用共享带宽创建IP时,带宽资源到期时间与IP的到期时间相同。

枚举值:

  • month

  • year

period_num

Integer

  • 功能说明:订购周期数

  • 取值范围:(后续会随运营策略变化)

    • period_type为month时,为[1,9]

    • period_type为year时,为[1,3]

  • 约束:同period_type约束。

最小值:1

最大值:9

is_auto_renew

Boolean

  • 功能说明:是否自动续订

  • 取值范围: false:不自动续订 true:自动续订

  • 约束:到期后,默认自动续订1个月(自动续订时间后续可能会变化),详情可联系客服咨询。

缺省值:false

is_auto_pay

Boolean

  • 功能说明:下单订购后,是否自动从客户的账户中支付

  • 取值范围:

    • true:自动支付,从账户余额自动扣费

    • false:只提交订单不支付,需要客户手动去支付

  • 约束:自动支付时,只能使用账户的现金支付;如果要使用代金券,请选择不自动支付,然后在用户费用中心,选择代金券支付。

缺省值:false

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

bandwidth_ids

Array

转包带宽列表

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

按需转包正常返回

错误码

请参见错误码

 

上一篇:云硬盘突发能力及原理 下一篇:CCI提供哪些容器实例类型?