文档首页/ 云备份 CBR/ API参考/ API/ 运营/ 变更 - ChangeOrder
更新时间:2026-07-21 GMT+08:00
分享

变更 - ChangeOrder

功能介绍

订单更新,调用该接口更新包周期产品订单信息,返回待支付订单信息。

该接口目前属于公测阶段,部分region暂时无法使用。

授权信息

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

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

POST /v3/{project_id}/orders/change

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,获取方法请参见获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

cloud_service_console_url

String

参数解释:

云服务console_url。 订购订单支付完成后,客户可以通过此URL跳转到云服务Console页面查看信息。

约束限制:

仅手动支付时涉及

取值范围:

字符串长度为1~512个字符。

默认取值:

不涉及

product_info

CbcProductInfoOrderChange object

参数解释:

产品信息

约束限制:

必填项,详见CbcProductInfoOrderChange表格

取值范围:

不涉及

默认取值:

不涉及

resource_id

String

参数解释:

待变更的资源ID,获取方法请参见获取存储库ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

is_auto_pay

Boolean

参数解释:

是否自动付费

约束限制:

不涉及

取值范围:

  • true:下单后自动付费

  • false:下单后不自动付费

默认取值:

false

promotion_info

String

参数解释:

购买折扣

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 CbcProductInfoOrderChange

参数

是否必选

参数类型

描述

product_id

String

参数解释:

产品标识,通过《客户运营能力》的“查询包年/包月产品价格”接口获取。

约束限制:

不涉及

取值范围:

长度限制:1-64,只能由字母、数字、“_”、“-”组成。

默认取值:

不涉及

resource_size

Integer

参数解释:

资源容量大小,单位GB。

约束限制:

不涉及。

取值范围:

10-10485760GB。

默认取值:

不涉及。

resource_size_measure_id

Integer

参数解释:

资源容量度量标识,例:枚举值17代表GB

约束限制:

不涉及

取值范围:

不涉及

默认取值:

17

resource_spec_code

String

参数解释:

用户购买云服务产品的资源规格。

约束限制:

不涉及

取值范围:

vault.backup.server.normal:云服务器存储库,

vault.backup.turbo.normal:弹性文件系统存储库,

vault.backup.database.normal:数据库存储库,

vault.backup.volume.normal:云硬盘存储库,

vault.backup.rds.normal:RDS存储库,

vault.replication.server.normal:云服务器复制存储库,

vault.hybrid.server.normal:云服务器混合云存储库

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

orderId

String

参数解释:

资源修改的订单ID

取值范围:

不涉及

retCode

Number

参数解释:

变更资源规格的状态响应码

取值范围:

不涉及

retMsg

String

参数解释:

变更的信息

取值范围:

不涉及

请求示例

变更包周期存储库大小到 50 GB

https://{endpoint}/v3/{project_id}/orders/change

{
  "resource_id" : "9dd8f8db-a926-440b-9af5-81b643618898",
  "product_info" : {
    "product_id" : "00301-34090-0--0",
    "resource_size" : 50,
    "resource_spec_code" : "vault.backup.server.normal"
  }
}

响应示例

状态码:200

OK

{
  "orderId" : "CS2305291628MSG5A",
  "retCode" : 0,
  "retMsg" : "success"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档