Changes the number of nodes in a PolarDB-X instance. You can call this operation to scale out or scale in a PolarDB-X instance. After you call this API operation, a transaction order is generated.

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 UpdatePolarDBXInstanceNode

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

RegionId String Yes cn-hangzhou

The ID of region in which the PolarDB-X instance you want to scale is located.

DBInstanceName String Yes pxc-hzjasdyuoo

The name of the PolarDB-X instance that you want to scale.

DbInstanceNodeCount String No 3

The number of nodes after the scaling operation. Valid values: 0 to 99.

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. The token is a random string.

CNNodeCount String No 2

The number of compute nodes in the instance.

DNNodeCount String No 2

The number of data nodes in the instance.

Response parameters

Parameter Type Example Description
OrderId String 20211103105558

The ID of the order that is generated for this request.

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

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=UpdatePolarDBXInstanceNode
&RegionId=cn-hangzhou
&DBInstanceName=pxc-hzjasdyuoo
&DbInstanceNodeCount=3
&ClientToken=FEA5DC20-6D8A-5979-97AA-FC57546ADC20
&CNNodeCount=2
&DNNodeCount=2
&Common request parameters

Sample success responses

XML format

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

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

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.