本文导读

展开导读

文档首页/ 文档数据库服务 DDS/ API参考/ API v3（推荐）/ 实例管理/ 删除实例的节点

删除实例的节点

更新时间：2023-11-24 GMT+08:00

查看PDF

接口说明

删除实例的节点。

约束说明

目前只支持副本集实例。
七副本集实例，可以删除2/4个备节点。
五副本集实例，可以删除2个备节点。
三副本集实例不可删除备节点。
存在异常节点的实例不能执行删除节点操作。

URI

URI格式
 DELETE https://{Endpoint}/v3/{project_id}/instances/{instance_id}/nodes
URI样例
 https://dds.cn-north-1.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/e73893ef73754465a8bd2e0857bbf13ein02/nodes

表1 请求参数
名称	类型	IN	是否必选	描述
X-Auth-Token	string	header	是	从IAM服务获取的用户Token。请参考认证鉴权。
project_id	string	path	是	租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。
instance_id	string	path	是	实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

请求消息

参数说明

表2 请求Body参数
参数	是否必选	参数类型	描述
num	否	Integer	删除的节点数量。
node_list	否	Array of strings	指定删除节点的ID列表。 num与node_list必须有一个字段传值。如果num与node_list同时传值时，则以node_list的值为准。删除的节点角色不能是Primary，以及Hidden。如果是多AZ实例，需满足删除指定节点后，每个AZ至少存在一个节点。

请求示例一：
```
{ 
   "num" : 2 
 }
```

请求示例二：

{ 
   "node_list" : [ 
                   "116ba14da34a42d28ecd83a38c218907no02",  
                   "642597740d884b9eb998338859eea6ceno02" ] 
 }

响应消息

参数说明

表3 响应Body参数
参数	参数类型	说明
job_id	String	任务ID，仅按需实例返回该参数。
order_id	String	订单ID，仅包周期实例返回该参数。

响应示例

{ 
  "job_id" : "6ad4eb1f-73bd-4876-aa31-aa9a1e41c4bc"  
}

状态码

详情请参见状态码。

错误码

详情请参见错误码。

父主题： 实例管理

上一篇：修改数据库复制集名称

下一篇：删除实例的只读节点

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消