调用DeleteDBNodes接口删除PolarDB集群的只读节点。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DeleteDBNodes | 系统规定参数。取值：DeleteDBNodes。 |
| DBClusterId | String | 是 | pc-************** | 集群ID。 |
| ClientToken | String | 否 | 6000170000591aed949d0f54a343f1a42*********** | 用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，保证在不同请求间唯一，大小写敏感、不超过64个ASCII字符。 |
| DBNodeId.N | String | 否 | pi-**************** | 集群节点ID。N为从1开始的正整数，最大值=当前节点数-2，即必须保留一个主节点和一个只读节点。 说明 目前仅PolarDB MySQL版集群支持一次删除多个只读节点。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 6566B2E6-3157-4B57-A693-AFB751****** | 请求ID。 |
| DBClusterId | String | pc-************** | 数据库集群ID。 |
| OrderId | String | 2035638******* | 订单ID。 |
示例
请求示例
http(s)://polardb.aliyuncs.com/?Action=DeleteDBNodes
&DBClusterId=pc-**************
&ClientToken=6000170000591aed949d0f54a343f1a42***********
&DBNodeId=["pi-****************"]
&<公共请求参数>正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DeleteDBNodesResponse>
<RequestId>6566B2E6-3157-4B57-A693-AFB751******</RequestId>
<DBClusterId>pc-**************</DBClusterId>
<OrderId>2035638*******</OrderId>
</DeleteDBNodesResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "6566B2E6-3157-4B57-A693-AFB751******",
"DBClusterId" : "pc-**************",
"OrderId" : "2035638*******"
}错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidDBNodeNum.Malformed | The number of parameter DBNode.N is not valid. | 参数DBNode的数量无效 |
| 403 | OperationDenied.DBNodeRole | The operation is not permitted due to the role of node. | 由于节点的角色，不允许该操作 |
| 404 | InvalidDBClusterId.NotFound | The DBClusterId provided does not exist in our records. | 当前的记录中不存在提供的 DBClusterId。 |
访问错误中心查看更多错误码。