Help Center/ GaussDB/ API Reference/ APIs (Recommended)/ Instance Management/ Changing the vCPUs and Memory of a DB Instance
Updated on 2025-08-19 GMT+08:00

Changing the vCPUs and Memory of a DB Instance

Function

This API is used to change the vCPUs and memory of a DB instance. Before calling this API:

Constraints

  • The OS architecture of the new specifications must be the same as that of the old specifications.

URI

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

Table 1 Parameter description

Name

Mandatory

Description

project_id

Yes

Definition

Project ID of a tenant in a region.

To obtain the value, see Obtaining a Project ID.

Constraints

N/A

Range

The value can contain 32 characters. Only letters and digits are allowed.

Default Value

N/A

instance_id

Yes

Definition

Instance ID, which uniquely identifies an instance.

Constraints

N/A

Range

The value can contain 36 characters. Only letters and digits are allowed.

Default Value

N/A

Request Parameters

Table 2 Parameter description

Name

Mandatory

Type

Description

flavor_ref

Yes

String

Definition

New specification code. To obtain its value, see the Specification Code column in Table 1.

To obtain its value, see Querying Instance Specifications.

Constraints

N/A

Range

N/A

Default Value

N/A

is_auto_pay

No

Boolean

Definition

Whether the order will be automatically paid after yearly/monthly instances are created. This parameter does not affect the payment mode of automatic renewal.

Constraints

N/A

Range

  • true: The order is automatically paid from the account.
  • false: The order is manually paid from the account.

Default Value

false

Response Parameters

Table 3 Response parameter description

Name

Type

Description

job_id

String

Definition

ID of changing instance specifications. This parameter is returned only when DB instances are billed at a pay-per-use basis.

Range

N/A

order_id

String

Definition

Order ID. This parameter is returned only when you change the specifications of a yearly/monthly instance.

Range

N/A

Example Request

Changing the specifications of a pay-per-use instance to 16 vCPUs and 128 GB

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" 
 }
Changing the specifications of a yearly/monthly DB instance from 8 vCPUs and 64 GB to 16 vCPUs and 128 GB
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
 }

Example Response

Instance specifications changed.

{
	"job_id": "2b414788a6004883a02390e2eb0ea227"
}

Status Code

Error Code

For details, see Error Codes.