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

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}/instance/{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. To obtain its value, see the Specification Code column in Table 1.

To obtain its value, see Querying Instance Specifications.

is_auto_pay

No

Boolean

Whether the order will be automatically paid after yearly/monthly instances are created. This parameter does not affect the payment mode 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 DB instances are billed at a pay-per-use basis.

order_id

String

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

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.

Parent topic: Instance Management