变更 - ChangeOrder
功能介绍
订单更新,调用该接口更新包周期产品订单信息,返回待支付订单信息。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
POST /v3/{project_id}/orders/change
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,获取方法请参见获取项目ID 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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 | 参数解释: 是否自动付费 约束限制: 不涉及 取值范围: 默认取值: false |
| promotion_info | 否 | String | 参数解释: 购买折扣 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 |
错误码
请参见错误码。