文档首页/ 分布式数据库中间件 DDM/ API参考/ API（推荐）/ 实例管理/ 变更DDM实例规格
更新时间：2024-09-25 GMT+08:00
查看PDF
分享

变更DDM实例规格

功能介绍

变更DDM实例规格。

接口约束

  • 实例状态仅为normal时，可以变更实例规格。
  • 需要变更的DDM实例规格不能与原DDM实例规格一样。
  • c6s系列规格不能变更为c6系列规格。

URI

PUT /v3/{project_id}/instances/{instance_id}/flavor

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一region下的project ID。

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

instance_id

是

String

DDM实例ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

x-auth-token

是

String

用户Token。

通过调用IAM服务的“获取用户Token”接口来获取。
表3 请求Body参数

参数

是否必选

参数类型

描述

spec_code

是

String

变更至新规格的资源规格编码。

group_id

否

String

实例默认一个组，此时不需要传入该参数。当使用组功能创建多个组时, 需要传入需要规格变更的对应组的group_id。

is_auto_pay

否

Boolean

变更包年包月实例规格时可指定，表示是否自动从账户中支付，此字段不影响自动续订的支付方式。true，表示自动从账户中支付。false，表示手动从账户中支付，默认为该方式。

响应参数

状态码： 202

表4 响应Body参数

参数

参数类型

描述

job_id

String

规格变更的任务ID，仅变更按需实例时会返回该参数。

order_id

String

订单ID，仅变更包周期实例时会返回该参数。

状态码： 400

表5 响应Body参数

参数

参数类型

描述

errCode

String

业务错误码。

externalMessage

String

错误信息。

状态码： 500

表6 响应Body参数

参数

参数类型

描述

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

错误码

请参见错误码。

父主题： 实例管理