删除PolarDB集群的只读节点。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
polardb:DeleteDBNodes |
delete |
*dbcluster
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| DBClusterId |
string |
是 |
集群 ID。 |
pc-************** |
| ClientToken |
string |
否 |
用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，保证在不同请求间唯一，大小写敏感、不超过 64 个 ASCII 字符。 |
6000170000591aed949d0f54a343f1a42*********** |
| DBNodeType |
string |
否 |
节点类型。取值范围：
枚举值：
|
RO |
| DBNodeId |
array |
是 |
集群节点 ID。 说明
您可以通过 DescribeDBClusters 接口查看账号下所有集群的详细信息，包括节点 ID。 |
pi-************ |
|
string |
否 |
集群节点 ID。N 为从 1 开始的正整数，最大值=当前节点数-2，即必须保留一个主节点和一个只读节点。 说明
目前仅 PolarDB MySQL 版集群支持一次删除多个只读节点。 |
pi-**************** |
|
| CloudProvider |
string |
否 |
ENS |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
6566B2E6-3157-4B57-A693-AFB751****** |
| DBClusterId |
string |
数据库集群 ID。 |
pc-************** |
| OrderId |
string |
订单 ID。 |
2035638******* |
示例
正常返回示例
JSON格式
{
"RequestId": "6566B2E6-3157-4B57-A693-AFB751******",
"DBClusterId": "pc-**************",
"OrderId": "2035638*******"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidDBNodeNum.Malformed | The number of parameter DBNode.N is not valid. | 参数DBNode的数量无效 |
| 400 | OperationDenied.DeleteDBNodesWithStrictConsistencyOn | 3AZ cluster does not allow delete db nodes. | 3AZ 集群不允许删除节点。 |
| 400 | InvalidDBNode.Malformed | The specified parameter DBNode.N is not valid. | 指定的参数DBNode.N无效。 |
| 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。 |
| 404 | InvalidDBClusterId.Malformed | The specified parameter DBClusterId is not valid. | 指定的参数DBClusterId无效 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。