调用CreateDBNodes接口增加PolarDB集群的只读节点。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateDBNodes | 系统规定参数。取值:CreateDBNodes。 |
ResourceGroupId | String | 否 | rg-************ | 资源组ID。 |
DBClusterId | String | 是 | pc-************* | 集群ID。 |
ClientToken | String | 否 | 6000170000591aed949d0f54a343f1a4233c1e7d1c5c****** | 用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,保证在不同请求间唯一,大小写敏感、不超过64个ASCII字符。 |
EndpointBindList | String | 否 | pe-****************,pe-**************** | 指定新增节点需要加入的集群连接地址的地址ID。若需要同时加入多个连接地址,多个连接地址ID间用英文逗号(,)分隔。 说明
|
PlannedStartTime | String | 否 | 2021-01-14T09:00:00Z | 开始执行定时(即在目标时间段内执行)新增节点任务的最早时间。格式为 说明
|
PlannedEndTime | String | 否 | 2021-01-14T09:30:00Z | 开始执行目标定时任务的最晚时间。格式为 说明
|
DBNode.N.TargetClass | String | 否 | polar.mysql.x4.medium | 新增节点的规格,需要与原有节点保持一致,详情请参见如下文档: |
DBNode.N.ZoneId | String | 否 | cn-qingdao-c | 新增节点的可用区,需要与原有节点保持一致。您可以通过DescribeRegions接口查询可用区ID。 说明
|
ImciSwitch | String | 否 | ON | 是否开启列存索引。取值范围:
说明 PolarDB PostgreSQL版(兼容Oracle)和PolarDB PostgreSQL版不支持该参数。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
DBNodeIds | Array of String | pi-*************** | 创建的DBNodeId列表。 |
RequestId | String | E053E730-5755-4AA9-AA9D-A47867****** | 请求ID。 |
DBClusterId | String | pc-*************** | 数据库集群ID。 |
OrderId | String | 2148126708***** | 订单ID。 |
示例
请求示例
http(s)://polardb.aliyuncs.com/?Action=CreateDBNodes
&ResourceGroupId=rg-************
&DBClusterId=pc-*************
&ClientToken=6000170000591aed949d0f54a343f1a4233c1e7d1c5c******
&EndpointBindList=pe-****************,pe-****************
&PlannedStartTime=2021-01-14T09:00:00Z
&PlannedEndTime=2021-01-14T09:30:00Z
&DBNode=[{"TargetClass":"polar.mysql.x4.medium","ZoneId":"cn-qingdao-c"}]
&ImciSwitch=ON
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateDBNodesResponse>
<DBNodeIds>pi-***************</DBNodeIds>
<RequestId>E053E730-5755-4AA9-AA9D-A47867******</RequestId>
<DBClusterId>pc-***************</DBClusterId>
<OrderId>2148126708*****</OrderId>
</CreateDBNodesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"DBNodeIds" : [ "pi-***************" ],
"RequestId" : "E053E730-5755-4AA9-AA9D-A47867******",
"DBClusterId" : "pc-***************",
"OrderId" : "2148126708*****"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | ORDER.ARREARAGE | 您有欠费账单,不符合购买条件,请先结清账单后再购买 | 您有欠费账单,不符合购买条件,请先结清账单后再购买 |
404 | InvalidDBClusterId.NotFound | The DBClusterId provided does not exist in our records. | 当前的记录中不存在提供的 DBClusterId。 |
访问错误中心查看更多错误码。