You can call this operation to add a node to a specified ApsaraDB for PolarDB cluster.

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
DBClusterId String Yes pc-xxxxxxxxxx

The ID of the cluster.
AccessKeyId String No key-test

The AccessKey ID provided to you by Alibaba Cloud.
Action String No CreateDBNodes

The operation that you want to perform. Set the value to CreateDBNodes.
ClientToken String No 6000170000591aed949d0f54a343f1a4233c1e7d1c5ca816be

The client token that is used to ensure the idempotence of the request. You can use the client to generate this value, but you must ensure that it is unique among different requests. The token is case-sensitive. It can contain only ASCII characters, and cannot exceed 64 characters in length.

DBNode.N.TargetClass String No polar.mysql.x2.medium

The specifications of the node, which must be the same as those of existing nodes. N is an integer that starts from 1. The maximum value of N is equal to 16 minus the number of current nodes. You must specify either the DBNode.N.ZoneId or DBNode.N.TargetClass parameter. For more information about specifications, see Specifications and pricing.

Note You can only add one node at a time. Valid value of N: 1.
DBNode.N.ZoneId String No cn-qingdao-c

The zone ID of the node to be added, which must be the same as that of existing nodes. N is an integer that starts from 1. The maximum value of N is equal to 16 minus the number of current nodes. You must specify either the DBNode.N.ZoneId or DBNode.N.TargetClass parameter. You can call the DescribeRegions operation to query the most recent region list.

Note You can only add one node at a time. Valid value of N: 1.

Response parameters

Parameter Type Example Description
DBClusterId String pc-xxxxxxxxxxxxx

The ID of the ApsaraDB for PolarDB cluster.
OrderId String 2035624xxxxxxxx

The ID of the order.
RequestId String C5BC3F8D-37C0-40EF-B5EF-457F983C612A

The ID of the request.

Examples

Sample requests


http(s)://[Endpoint]/? Action=CreateDBNodes
&DBClusterId=pc-xxxxxxxxxx
&<Common request parameters>

Sample success responses

XML format 

<CreateDBNodesResponse>  
      <OrderId>2035624xxxxxxxx</OrderId>
      <RequestId>C5BC3F8D-37C0-40EF-B5EF-457F983C612A</RequestId>
      <DBClusterId>pc-xxxxxxxxxxxxx</DBClusterId>
</CreateDBNodesResponse>

JSON format 

{
    "OrderId": 2035624xxxxxxxx,
    "RequestId": "C5BC3F8D-37C0-40EF-B5EF-457F983C612A",
    "DBClusterId": "pc-xxxxxxxxxxxxx"
}

Error codes

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