Changing DB Instance Specifications¶
Function¶
This API is used to change DB instance specifications.
Important
Services will be interrupted for 5 to 10 minutes when you change DB instance specifications. Exercise caution when performing this operation.
URI¶
URI format
PATH: /rds/v1/{project_id}/instances/{instanceId}/action
Method: POST
Parameter description
Table 1 Parameter description¶ Name
Mandatory
Description
project_id
Yes
Specifies the project ID of a tenant in a region.
instanceId
Yes
Specifies the primary node ID of the DB instance.
Note
This field is not the DB instance ID. You are advised to use API v3 and the DB instance ID to perform related operations.
Restrictions
The new specifications cannot be the same as the original specifications.
The instance class can be modified only for DB instances whose status is Available.
The specifications of a DB instance can be changed to the specifications of the same instance type. For example, you cannot change the specifications of a single DB instance to those of primary/standby DB instances.
Request¶
Parameter description
Table 2 Parameter description¶ Name
Type
Description
resize
Dictionary data structure. For details, see Table 3.
Specifies the information about the returned parameter flavorRef.
Table 3 resize field data structure description¶ Name
Type
Description
flavorRef
String
Specifies the specification ID (flavors.id in the response message in section Obtaining All DB Instance Specifications).
Request example
POST https://{Endpoint}/rds/v1/375d8d8fad1f43039e23d3b6c0f60a19/instances/02cf1fd7-24ae-4fec-a621-329ec732e4f6/action{ "resize":{ "flavorRef":"0d922098-553c-4123-80df-e627a1d41a0d" } }
Normal Response¶
Parameter description
Table 4 Parameter description¶ Name
Type
Description
jobId
List data structure
Indicates the jobId information.
Response example
{ "jobId": [ "ff8080815703e6de015703e98504001a" ] }
Abnormal Response¶
For details, see Abnormal Request Results.
Status Code¶
For details, see Status Codes.
Error Code¶
For details, see Error Codes.