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 ID of region in which the instance you want to change is located.

DBInstanceName String Yes pxc-hzjasd****

The ID of the instance whose type you want to change.

TargetDBInstanceClass String Yes polarx.x4.xlarge.2e

The new instance type of the instance. Valid values:

  • polarx.x4.medium.2e: Instances of this type have 2 CPU cores and 8 GB of memory.
  • polarx.x4.large.2e: Instances of this type have 4 CPU cores and 16 GB of memory.
  • polarx.x8.large.2e: Instances of this type have 4 CPU cores and 32 GB of memory.
  • polarx.x4.xlarge.2e: Instances of this type have 8 CPU cores and 32 GB of memory.
  • polarx.x8.xlarge.2e: Instances of this type have 8 CPU cores and 64 GB of memory.
  • polarx.x4.2xlarge.2e: Instances of this type have 16 CPU cores and 64 GB of memory.
  • polarx.x8.2xlarge.2e: Instances of this type have 16 CPU cores and 128 GB of memory.
  • polarx.x4.4xlarge.2e: Instances of this type have 32 CPU cores and 128 GB of memory.
  • polarx.x8.4xlarge.2e: Instances of this type have 32 CPU cores and 256 GB of memory.
  • polarx.st.8xlarge.2e: Instances of this type have 60 CPU cores and 470 GB of memory.
  • polarx.st.12xlarge.2e: Instances of this type have 90 CPU cores and 720 GB of 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.

CnClass String No 4 CPU cores, 32 GB memory

The specifications of compute nodes in the instance.

DnClass String No 4 cores, 32 GB memory

The specifications of storage nodes in the instance.

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
&CnClass=4 CPU cores, 32 GB memory
&DnClass=4 CPU cores, 32 GB memory
&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.