Help Center> GaussDB> API Reference> APIs (Recommended)> Instance Management> Changing the vCPUs and Memory of a DB Instance
Updated on 2024-05-21 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}/instance/{instance_id}/flavor

Table 1 Parameter description

Name

Mandatory

Description

project_id

Yes

Project ID of a tenant in a region.

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

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 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