Changing DB Instance Specifications

Function

This API is used to change DB instance specifications.

• Before calling this API, learn how to authenticate it.
• Before calling this API, learn about request header parameters.

Constraints

• Services will be interrupted for 5 to 10 minutes when you change DB instance specifications. Exercise caution when performing this operation.
• The new DB instance specifications must be different from the original DB instance specifications.
• The instance specifications can be modified only for DB instances in the Available status.
• The specifications of a DB instance can be changed only to the specifications of the same DB instance type. (For example, the specifications of a single DB instance cannot be changed to those of primary/standby DB instances.)

URI

• URI format

  POST /v3/{project_id}/instances/{instance_id}/action

• Parameter description

  Table 1 Parameters

  Parameter	Mandatory	Description
  project_id	Yes	Project ID of a tenant in a region. To obtain the value, see Obtaining a Project ID.
  instance_id	Yes	Specifies the DB instance ID.

Request

Example Request

• Change the specifications of an RDS for MySQL DB instance to rds.mysql.m1.xlarge.

  POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action
  
  {
  	"resize_flavor": {
  		"spec_code": "rds.mysql.m1.xlarge",
                  "is_auto_pay": true
  	}
  }

• Change the specifications of an RDS for PostgreSQL DB instance to rds.pg.c2.medium.ha.

  {
  	"resize_flavor": {
  		"spec_code": "rds.pg.c2.medium.ha",
                  "is_auto_pay": true
  	}
  }

• Change the specifications of an RDS for SQL Server DB instance to rds.mssql.2014.se.s3.large.2.

  {
  	"resize_flavor": {
  		"spec_code": "rds.mssql.2014.se.s3.large.2",
                  "is_auto_pay": true
  	}
  }

Response

• Pay-per-use
  • Normal response

    Table 4 Parameters

    Parameter	Type	Description
    job_id	String	Indicates the job ID.

  • Example normal response

    {
    	"job_id": "2b414788a6004883a02390e2eb0ea227"
    }

  • Abnormal response

    For details, see Abnormal Request Results.

Status Code

• Normal

  202

• Abnormal

  For details, see Status Codes.

Error Code

For details, see Error Codes.