变更DDM实例规格
功能介绍
变更DDM实例规格。
接口约束
- 实例状态仅为normal时,可以变更实例规格。
- 需要变更的DDM实例规格不能与原DDM实例规格一样。
- c6s系列规格不能变更为c6系列规格。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
PUT /v3/{project_id}/instances/{instance_id}/flavor
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
租户在某一region下的project ID。 获取方法请参见获取项目ID。 |
instance_id |
是 |
String |
DDM实例ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
x-auth-token |
是 |
String |
用户Token。 通过调用IAM服务的“获取用户Token”接口来获取。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
spec_code |
是 |
String |
变更至新规格的资源规格编码。 |
group_id |
否 |
String |
实例默认一个组,此时不需要传入该参数。当使用组功能创建多个组时, 需要传入需要规格变更的对应组的group_id。 |
is_auto_pay |
否 |
Boolean |
变更包年包月实例规格时可指定,表示是否自动从账户中支付,此字段不影响自动续订的支付方式。true,表示自动从账户中支付。false,表示手动从账户中支付,默认为该方式。 |
响应参数
状态码: 202
参数 |
参数类型 |
描述 |
---|---|---|
job_id |
String |
规格变更的任务ID,仅变更按需实例时会返回该参数。 |
order_id |
String |
订单ID,仅变更包周期实例时会返回该参数。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
errCode |
String |
业务错误码。 |
externalMessage |
String |
错误信息。 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
errCode |
String |
业务错误码。 |
externalMessage |
String |
错误信息。 |
请求示例
变更实例规格为ddm.c6.4xlarge.2。
PUT https://{endpoint}/v3/{project_id}/instances/{instance_id}/flavor { "spec_code" : "ddm.c6.4xlarge.2", "group_id" : "3e5a9063d3b84729b0a3310fad3a0942gr09", "is_auto_pay" : false }
响应示例
状态码: 202
ok
{ "job_id" : "2x414788a5112333a02390e2eb0ea227" }
状态码
状态码 |
描述 |
---|---|
202 |
OK |
400 500 |
bad request server error |
错误码
请参见错误码。