文档首页/ 弹性公网IP EIP/ API参考/ API/ 带宽(V2.0)/ 按需转包年/包月带宽 - ChangeBandwidthToPeriod
更新时间：2025-10-24 GMT+08:00
在线调试
CLI示例
查看PDF
分享

按需转包年/包月带宽 - ChangeBandwidthToPeriod

功能介绍

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

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    eip:bandwidths:update

    Write

    bandwidth *

    • g:EnterpriseProjectId

    • g:ResourceTag/<tag-key>
    • vpc:bandwidths:update

    bss:renewal:update

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取项目ID请参见获取项目ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

bandwidth_ids

是

Array of strings

待按需转包带宽列表

extendParam

是

CreatePrePaidPublicipExtendParamOption object

按需转包周期参数
表3 CreatePrePaidPublicipExtendParamOption

参数

是否必选

参数类型

描述

charge_mode

是

String

  • 功能说明：付费方式,需显式指定转为包年/包月

period_type

是

String

  • 功能说明：订购资源的周期类型（包年、包月）

  • 取值范围：

    • month 包月

    • year 包年

period_num

是

Integer

  • 功能说明：订购周期数，和period_type组合使用。举例需订购3个月时，period_type取值month，period_num取值3。

  • 取值范围：（以下为常见约束，实际以具体产品运营策略为准）

    • period_type为month时，可取[1,9]的整数

    • period_type为year时，可取[1,3]的整数

最小值：1

最大值：9

is_auto_renew

否

Boolean

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

  • 取值范围：

  • 约束：到期后，默认自动续订1个月（自动续订策略以站点运营为准），详情可联系客服咨询。

false：不自动续订

true：自动续订

缺省值：false

is_auto_pay

否

Boolean

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

  • 取值范围：

    • true：自动支付，从账户余额自动扣费

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

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

缺省值：false

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

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

按需转包正常返回

错误码

请参见错误码。

父主题： 带宽(V2.0)

相关文档