该接口用于调整预留实例券。
- 不支持同时调整可用区和预留实例券名称。
请求结构
PUT /v{version}/instance/reserved/modify HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
{
"reservedInstances": [
{
"reservedInstanceId": "reservedInstanceId",
"zoneName": "zoneName",
"ehcClusterId": "ehcClusterId"
}
]
} 请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| clientToken | String | 否 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串，详见链接。 |
| reservedInstanceId | String | 是 | requestBody参数 | 要调整的预留实例券id |
| zoneName | String | 否 | requestBody参数 | 要调整的目标可用区，例如：cn-bj-b。不支持同时修改reservedInstanceName |
| reservedInstanceName | String | 否 | requestBody参数 | 要调整的实例券名称；规则：支持大小写字母、数字、中文以及-_ /.特殊字符，必须以中文或字母开头，长度1-65，可重复；客户未命名的情况下自动命名：reservedInstance-${随机生成}，同样遵循以上命名规则。不支持同时修改zoneName |
| ehcClusterId | String | 否 | requestBody参数 | 变更roce预留实例券时可选参数，若为空则使用默认EHC集群 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| modifyReservedInstanceOrders | Array | 调整预留实例券的返回集合 |
| reservedInstanceId | String | 预留实例券的id |
| orderId | String | 预留实例券变更的订单号 |
错误码
| 错误码 | 错误描述 | HTTP状态码 | 中文解释 |
|---|---|---|---|
| BadRequest | request is invalid | 400 | 请求参数无效 |
请求示例
PUT http://bcc.bj.baidubce.com/v2/instance/reserved/modify
Host: bcc.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"reservedInstances": [
{
"reservedInstanceId": "r-yeeVFWyn",
"zoneName": "cn-bj-b"
}
]
}返回示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
"modifyReservedInstanceOrders": [
{
"reservedInstanceId": "test_b0e3d7387d0b",
"orderId": "test_5cf7663b10de"
}
]
}