Updated on 2024-09-04 GMT+08:00

Upgrading a FlexusRDS Instance to an RDS Instance

Function

This API is used to change DB instance specifications.

Services will be interrupted for 5 to 10 minutes when you change DB instance specifications. Exercise caution when performing this operation.

Constraints

  • 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-node instance cannot be changed to those of primary/standby instances.)

URI

  • URI format

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

  • Parameter description
    Table 1 Parameters

    Parameter

    Mandatory

    Type

    Description

    project_id

    Yes

    String

    Explanation:

    Project ID of a tenant in a region.

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

    Constraints:

    N/A

    Value range:

    N/A

    Default value:

    N/A

    instance_id

    Yes

    String

    Explanation:

    Instance ID.

    Constraints:

    N/A

    Value range:

    N/A

    Default value:

    N/A

Request

Table 2 Parameters

Parameter

Mandatory

Type

Description

resize_flavor

Yes

Object

Explanation:

Specification information. For details, see Table 3.

Constraints:

N/A

Table 3 resize_flavor field data structure description

Parameter

Mandatory

Type

Description

spec_code

Yes

String

Explanation:

Resource specification code.

Constraints:

N/A

Value range:

Example value: rds.mysql.y1.xlarge.2. rds indicates the RDS product, mysql indicates the DB engine, and y1.xlarge indicates the lightweight performance specifications.

Default value:

N/A

is_auto_pay

No

Boolean

Explanation:

Whether the order will be automatically paid.

Constraints:

N/A

Value range:

  • true: indicates the order will be automatically paid.
  • false: indicates the order will be manually paid.

Default value:

false

is_delay

No

Boolean

Explanation:

Whether to change the specifications at the scheduled time.

Constraints:

N/A

Value range:

  • true: The specifications will be changed in the maintenance window.
  • false: The specifications will be changed immediately upon the request submission.

Default value:

false

Example Request

Change the specifications of a FlexusRDS 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,
                "is_delay": true
	}
}

Response

  • Normal response
    Table 4 Parameters

    Parameter

    Type

    Description

    order_id

    String

    Explanation:

    Order ID.

    Value range:

    N/A

  • Example normal response
    {
    	"order_id": "CS2009151216NO2U1"
    }
  • Abnormal response

    For details, see Abnormal Request Results.

Status Code