文档首页/ 云数据库 GaussDB/ API参考/ API(推荐)/ 实例管理/ 变更实例规格 - ChangingtheCPUandMemorySpecificationsofanInstance
更新时间:2025-12-25 GMT+08:00
分享

变更实例规格 - ChangingtheCPUandMemorySpecificationsofanInstance

功能介绍

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

接口约束

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

调试

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

URI

PUT /v3/{project_id}/instances/{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。

cn_concurrent_resize_num

Integer

参数解释:

指定CN节点的规格变更并行数。

调整CN节点并行变更数可以加快规格变更的过程,建议使用系统默认配置的规格。如需调整,请根据当前系统负载评估剩余CN节点业务负载变化情况,确保业务稳定性和中断时长在可接受范围内。

约束限制:

仅对独立部署形态实例生效。

取值范围:

[1, floor(总协调节点数/2)],单批次最多变更20个协调节点。

默认取值

1

dn_concurrent_resize_num

Integer

参数解释:

指定DN节点的规格变更并行数。

调整DN节点并行变更数可以加快规格变更的过程,建议使用系统默认配置的规格。如需调整,建议根据当前系统负载评估短时间内倒换DN节点数量情况,确保业务稳定性和中断时长在可接受范围内。

约束限制:

不涉及。

取值范围:

  • 当总分片数<=5时,取值范围为[1, 总分片数]。
  • 当总分片数>5时,取值范围为[1, max(floor(分片数/2),5)],单批次最多变更20个分片。

默认取值

不指定分片并发数时,分为以下两种情况:

  • 当总分片数<=5时,默认一起变更。
  • 当总分片数>5时,默认每次变更5个,最后一批可不足5个。

响应参数

表3 响应参数说明

名称

参数类型

说明

job_id

String

参数解释:

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

取值范围:

不涉及。

order_id

String

参数解释:

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

取值范围:

不涉及。

请求示例

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

PUT https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/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/instances/dsfae23fsfdsae3435in14/flavor
{ 
        "flavor_ref":"gaussdb.opengauss.ee.dn.m6.4xlarge.8.in",
        "is_auto_pay":true
 }

响应示例

变更实例规格成功。

{
	"job_id": "2b414788a6004883a02390e2eb0ea227"
}

状态码

错误码

请参见错误码

相关文档