Changes the instance type of a PolarDB-X instance.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyDBInstanceClass

The operation that you want to perform. Set the value to ModifyDBInstanceClass.

RegionId String Yes cn-hangzhou

The region ID of the instance.

DBInstanceName String Yes pxc-hzjasd****

The ID of the instance.

TargetDBInstanceClass String Yes polarx.x4.xlarge.2e

The new instance type of the instance. Valid values:

  • polarx.x4.large.2e: This instance type specifies 4 CPU cores and 16 GB memory. This instance type is available only for the Starter Edition.
  • polarx.x4.xlarge.2e: This instance type specifies 8 CPU cores and 32 GB memory.
  • polarx.x4.2xlarge.2e: This instance type specifies 16 CPU cores and 64 GB memory.
  • polarx.x4.4xlarge.2e: This instance type specifies 32 CPU cores and 128 GB memory.
ClientToken String Yes FEA5DC20-6D8A-5979-97AA-FC57546ADC20

The client token that is used to ensure the idempotence of the request. You can use the client to generate the value, but you must make sure that it is unique among different requests.

Response parameters

Parameter Type Example Description
OrderId String 20211103105558

The ID of the order. An order is created each time you upgrade or downgrade the specifications of your instance or change the instance type of your instance.

RequestId String FEA5DC20-6D8A-5979-97AA-FC57546ADC20

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ModifyDBInstanceClass
&RegionId=cn-hangzhou
&DBInstanceName=pxc-hzjasd****
&TargetDBInstanceClass=polarx.x4.xlarge.2e
&ClientToken=FEA5DC20-6D8A-5979-97AA-FC57546ADC20
&<Common request parameters>

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyDBInstanceClassResponse>
    <OrderId>20211103105558</OrderId>
    <RequestId>FEA5DC20-6D8A-5979-97AA-FC57546ADC20</RequestId>
</ModifyDBInstanceClassResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "OrderId" : "20211103105558",
  "RequestId" : "FEA5DC20-6D8A-5979-97AA-FC57546ADC20"
}

Error codes

For a list of error codes, visit the API Error Center.