文档首页/ 云数据库 GaussDB/ API参考/ API（推荐）/ 实例管理/ 变更实例规格
更新时间：2025-10-14 GMT+08:00
查看PDF
分享

变更实例规格

功能介绍

通过调用该接口提升实例的CPU和内存。

接口约束

  • 新规格和旧规格的操作系统架构必须相同。

调试

您可以在API Explorer中调试该接口。

URI

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

表1 参数说明

名称

是否必选

说明

project_id

是

参数解释：

租户在某一Region下的项目ID。

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

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

instance_id

是

参数解释：

实例ID，此参数是用户创建实例的唯一标识。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为36个字符。

默认取值：

不涉及。

请求参数

表2 参数说明

名称

是否必选

参数类型

说明

flavor_ref

是

String

参数解释：

规格变更的新规格的资源规格编码。参考表1中的“规格编码”列内容获取。

参考查询数据库规格中“spec_code”字段获取。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

is_auto_pay

否

Boolean

参数解释：

包周期实例时可指定，表示是否自动从账户中支付，此字段不影响自动续订的支付方式。

约束限制：

不涉及。

取值范围：

  • true，表示自动从账户中支付。
  • false，表示手动从账户中支付，默认为该方式。

默认取值：

false

响应参数

表3 响应参数说明

名称

参数类型

说明

job_id

String

参数解释：

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

取值范围：

不涉及。

order_id

String

参数解释：

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

取值范围：

不涉及。

请求示例

变更按需实例的规格，变更为16U128G。

PUT https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instance/dsfae23fsfdsae3435in14/flavor
{ 
        "flavor_ref":"gaussdb.opengauss.ee.dn.m6.4xlarge.8.in" 
 }
变更包周期实例的规格，从8U64G变更为16U128G。 
PUT https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instance/dsfae23fsfdsae3435in14/flavor
{ 
        "flavor_ref":"gaussdb.opengauss.ee.dn.m6.4xlarge.8.in",
        "is_auto_pay":true
 }

响应示例

变更实例规格成功。

{
	"job_id": "2b414788a6004883a02390e2eb0ea227"
}

状态码

错误码

请参见错误码。

父主题： 实例管理

相关文档