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

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 https://{Endpoint}/v3/{project_id}/instances/{instance_id}/flavor

Table 1 Parameter description

Name

Mandatory

Description

project_id

Yes

Explanation:

Project ID of a tenant in a region.

For details about how to obtain the project ID, see Obtaining a Project ID.

Restrictions:

None

Value range:

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

Default value:

None

instance_id

Yes

Instance ID.

Request Parameters

Table 2 Parameter description

Name

Mandatory

Type

Description

flavor_ref

Yes

String

New specification code. For details on how to obtain the specification code, see Table 1.

To obtain its value, see the spec_code field in Querying Instance Specifications.

is_auto_pay

No

Boolean

Payment method. When creating a yearly/monthly instance, you can specify whether to automatically pay with your account. This parameter does not affect the payment method of automatic renewal.

  • true: indicates that the order is automatically paid from the account.
  • false: indicates that the order is manually paid from the account. The default value is false.

Response Parameters

Table 3 Response parameter description

Name

Type

Description

job_id

String

ID of changing instance specifications. This parameter is returned only when you change the specifications of a pay-per-use instance.

Example Request

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

PUT https://gaussdb-opengauss.eu-west-101.myhuaweicloud.eu/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in14/flavor
{ 
        "flavor_ref":"gaussdb.opengauss.ee.dn.m6.4xlarge.8.in" 
 }
Changing the specifications of a yearly/monthly instance from 8 vCPUs and 64 GB to 16 vCPUs and 128 GB 
PUT https://gaussdb-opengauss.eu-west-101.myhuaweicloud.eu/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in14/flavor
{ 
        "flavor_ref":"gaussdb.opengauss.ee.dn.m6.4xlarge.8.in",
        "is_auto_pay":true
 }

Example Response

Instance specifications are changed.

{
	"job_id": "2b414788a6004883a02390e2eb0ea227"
}

Status Code

Error Codes

For details, see Error Codes.

Parent topic: Instance Management