调用CreateDBNodes接口增加PolarDB集群的只读节点。

调试

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

请求参数

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

系统规定参数,取值:CreateDBNodes

DBClusterId String pc-*************

集群ID。

DBNode.N.TargetClass String polar.mysql.x4.medium

新增节点的规格,需要与原有节点保持一致,关于节点规格,详情请参见规格与定价

说明
  • DBNode.N.ZoneId和DBNode.N.TargetClass,至少填一个。 N为从1开始的整数,最大值=16-当前节点数。
  • 当前仅PolarDB MySQL集群支持一次增加多个只读节点,最多可增加至15个只读节点。
DBNode.N.ZoneId String cn-qingdao-c

新增节点的可用区,需要与原有节点保持一致。您可以通过DescribeRegions接口查询可用区ID。

说明
  • DBNode.N.ZoneId和DBNode.N.TargetClass,至少填一个。N为从1开始的整数,最大值=16-当前节点数。
  • 当前仅PolarDB MySQL集群支持一次增加多个只读节点,最多可增加至15个只读节点。
ClientToken String 6000170000591aed949d0f54a343f1a4233c1e7d1c5c******

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

返回数据

名称 类型 示例值 描述
DBClusterId String pc-***************

数据库集群ID。

DBNodeIds List pi-***************

创建的DBNodeId列表。

OrderId String 11111111111111

订单ID。

RequestId String E053E730-5755-4AA9-AA9D-A47867******

请求ID。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=CreateDBNodes
&DBClusterId=pc-*************
&<公共请求参数>

正常返回示例

XML 格式

<CreateDBNodesResponse>
  <DBNodeIds>
        <DBNodeId>pi-***************</DBNodeId>
        <DBNodeId>pi-***************</DBNodeId>
  </DBNodeIds>
  <RequestId>E053E730-5755-4AA9-AA9D-A47867******</RequestId>
  <DBClusterId>pc-***************</DBClusterId>
  <OrderId>11111111111111</OrderId>
</CreateDBNodesResponse>

JSON 格式

{
	"DBNodeIds": {
		"DBNodeId": [
			"pi-***************",
			"pi-***************"
		]
	},
	"RequestId": "E053E730-5755-4AA9-AA9D-A47867******",
	"DBClusterId": "pc-***************",
	"OrderId": 11111111111111
}

错误码

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