調(diào)用CreateDBNodes接口增加PolarDB集群的只讀節(jié)點(diǎn)。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateDBNodes | 系統(tǒng)規(guī)定參數(shù)。取值:CreateDBNodes。 |
ResourceGroupId | String | 否 | rg-************ | 資源組ID。 |
DBClusterId | String | 是 | pc-************* | 集群ID。 |
ClientToken | String | 否 | 6000170000591aed949d0f54a343f1a4233c1e7d1c5c****** | 用于保證請(qǐng)求的冪等性,防止重復(fù)提交請(qǐng)求。由客戶端生成該參數(shù)值,保證在不同請(qǐng)求間唯一,大小寫敏感、不超過(guò)64個(gè)ASCII字符。 |
EndpointBindList | String | 否 | pe-****************,pe-**************** | 指定新增節(jié)點(diǎn)需要加入的集群連接地址的地址ID。若需要同時(shí)加入多個(gè)連接地址,多個(gè)連接地址ID間用英文逗號(hào)(,)分隔。 說(shuō)明
|
PlannedStartTime | String | 否 | 2021-01-14T09:00:00Z | 開(kāi)始執(zhí)行定時(shí)(即在目標(biāo)時(shí)間段內(nèi)執(zhí)行)新增節(jié)點(diǎn)任務(wù)的最早時(shí)間。格式為 說(shuō)明
|
PlannedEndTime | String | 否 | 2021-01-14T09:30:00Z | 開(kāi)始執(zhí)行目標(biāo)定時(shí)任務(wù)的最晚時(shí)間。格式為 說(shuō)明
|
DBNode.N.TargetClass | String | 否 | polar.mysql.x4.medium | 新增節(jié)點(diǎn)的規(guī)格,需要與原有節(jié)點(diǎn)保持一致,詳情請(qǐng)參見(jiàn)如下文檔:
|
DBNode.N.ZoneId | String | 否 | cn-qingdao-c | 新增節(jié)點(diǎn)的可用區(qū),需要與原有節(jié)點(diǎn)保持一致。您可以通過(guò)DescribeRegions接口查詢可用區(qū)ID。 說(shuō)明
|
ImciSwitch | String | 否 | ON | 是否開(kāi)啟列存索引。取值范圍:
說(shuō)明 PolarDB PostgreSQL版(兼容Oracle)和PolarDB PostgreSQL版不支持該參數(shù)。 |
返回?cái)?shù)據(jù)
名稱 | 類型 | 示例值 | 描述 |
---|---|---|---|
DBNodeIds | Array of String | pi-*************** | 創(chuàng)建的DBNodeId列表。 |
RequestId | String | E053E730-5755-4AA9-AA9D-A47867****** | 請(qǐng)求ID。 |
DBClusterId | String | pc-*************** | 數(shù)據(jù)庫(kù)集群ID。 |
OrderId | String | 2148126708***** | 訂單ID。 |
示例
請(qǐng)求示例
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
&<公共請(qǐng)求參數(shù)>
正常返回示例
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*****"
}
錯(cuò)誤碼
HttpCode | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
---|---|---|---|
400 | ORDER.ARREARAGE | 您有欠費(fèi)賬單,不符合購(gòu)買條件,請(qǐng)先結(jié)清賬單后再購(gòu)買 | 您有欠費(fèi)賬單,不符合購(gòu)買條件,請(qǐng)先結(jié)清賬單后再購(gòu)買 |
404 | InvalidDBClusterId.NotFound | The DBClusterId provided does not exist in our records. | 當(dāng)前的記錄中不存在提供的 DBClusterId。 |
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。