文档首页/云数据库 GaussDB/API参考/历史API/实例管理/变更实例规格 - ChangingthevCPUsandMemoryofaDBInstance
更新时间：2025-12-26 GMT+08:00
查看PDF
分享

变更实例规格 - ChangingthevCPUsandMemoryofaDBInstance

功能介绍

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

接口约束

  • 规格变更前，须确保实例状态正常。实例异常，节点异常均不允许进行规格变更。
  • 新规格和旧规格的操作系统架构必须相同。
  • 修改CPU|内存后，将会重启数据库实例，重启后实例会自动释放内存中的缓存，请在业务低峰期进行重启，避免对高峰期业务造成影响。
  • 规格变更过程中会进行主备倒换。
  • 单副本的部署形态下，规格变更过程中会进行中断重启，中断重启过程中会有5~10min的业务中断。

调试

您可以在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中的“规格编码”列内容获取。

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

is_auto_pay

否

Boolean

参数解释：

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

约束限制：

不涉及。

取值范围：

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

默认取值：

false

响应参数

表3 响应参数说明

名称

参数类型

说明

job_id

String

参数解释：

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

取值范围：

不涉及。

order_id

String

参数解释：

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

取值范围：

不涉及。

请求示例

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

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

响应示例

变更实例规格成功。

{
	"job_id": "2b414788a6004883a02390e2eb0ea227"
}

状态码

错误码

请参见错误码。

父主题：实例管理