该接口用于增加POLARDB集群的只读节点。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 否 CreateDBNodes

系统规定参数，取值：CreateDBNodes。
DBClusterId String 是 pc-xxxxxxxxxx

集群ID。
DBNode.N.TargetClass String 否 polar.mysql.x2.medium

新增节点的规格，需要与原有节点保持一致。N为从1开始的整数，最大值=16-当前节点数。DBNode.N.ZoneId和DBNode.N.TargetClass，至少填一个。规格详情请参见规格与定价。

说明 当前暂不支持一次增加多个节点，一次只能增加一个节点，N的取值为1。
DBNode.N.ZoneId String 否 cn-qingdao-c

新增节点的可用区，需要与原有节点保持一致。N为从1开始的整数，最大值=16-当前节点数。DBNode.N.ZoneId和DBNode.N.TargetClass，至少填一个。可用区ID可以通过接口DescribeRegions查询。

说明 当前暂不支持一次增加多个节点，一次只能增加一个节点，N的取值为1。
ClientToken String 否 6000170000591aed949d0f54a343f1a4233c1e7d1c5ca816be

用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，保证在不同请求间唯一，大小写敏感、不超过64个ASCII字符。

返回数据

名称 类型 示例值 描述
RequestId String 42AA571A-7DED-4B2D-80A0-D1865678D53A

请求ID。
DBClusterId String pc-xxxxxxxxxxxxx

数据库集群ID。
OrderId String 123123123123123

订单ID。
DBNodeIds List pi-xxxxxxxxxxxx

创建的DBNodeId列表。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateDBNodes
&DBClusterId=pc-xxxxxxxxxx
&<公共请求参数>

正常返回示例

XML 格式 

<DBNodeIds>
    <DBNodeId>pi-xxxxxxxxxxxx</DBNodeId>
</DBNodeIds>
<RequestId>42AA571A-7DED-4B2D-80A0-D1865678D53A</RequestId>
<OrderId>123123123123123</OrderId>
<DBClusterId>pc-xxxxxxxxxxxx</DBClusterId>

JSON 格式 

{
	"DBNodeIds": {
		"DBNodeId": [
			"pi-xxxxxxxxxxxx"
		]
	},
	"RequestId": "42AA571A-7DED-4B2D-80A0-D1865678D53A",
	"OrderId": 123123123123123,
	"DBClusterId": "pc-xxxxxxxxxxxx"
}

错误码

访问错误中心查看更多错误码。