# 变更 - ChangeOrder
#### 功能介绍
订单更新，调用该接口更新包周期产品订单信息，返回待支付订单信息。
![](https://support.huaweicloud.com/api-cbr/public_sys-resources/note_3.0-zh-cn.png)
该接口目前属于公测阶段，部分Region暂时无法使用。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cbr/cbr_04_0017.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
POST /v3/{project_id}/orders/change
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释：** 项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-cbr/cbr_04_0022.html) **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
   
#### 请求参数
表2请求Body参数 
| 参数                        | 是否必选 | 参数类型                                                                                | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| cloud_service_console_url | 否    | String                                                                              | **参数解释：** 云服务console_url。 订购订单支付完成后，客户可以通过此URL跳转到云服务Console页面查看信息。 **约束限制：** 仅手动支付时涉及 **取值范围：** 字符串长度为1\~512个字符。 **默认取值：** 不涉及                                                                                                                                                                                                                                                            |
| product_info              | 是    | [CbcProductInfoOrderChange] object | **参数解释：** 产品信息 **约束限制：** 必填项，详见CbcProductInfoOrderChange表格 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                    |
| resource_id               | 是    | String                                                                              | **参数解释：** 待变更的资源ID，获取方法请参见[获取存储库ID](https://support.huaweicloud.com/api-cbr/ListVault.html) **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                     |
| is_auto_pay               | 否    | Boolean                                                                             | **参数解释：** 是否自动付费 **约束限制：** 不涉及 **取值范围：** - true：下单后自动付费   - false：下单后不自动付费    **默认取值：** false |
| promotion_info            | 否    | String                                                                              | **参数解释：** 购买折扣 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                  |
   
 表3CbcProductInfoOrderChange 
| 参数                       | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| 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
```
POST 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**
```
{
  "orderId" : "CS2305291628MSG5A",
  "retCode" : 0,
  "retMsg" : "success"
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cbr/ErrorCode.html)。
