移除存储池内的节点
更新时间 2026-06-26 09:37:07
最近更新时间: 2026-06-26 09:37:07
本节主要介绍如何使用API移除存储池内的节点。
此操作用来移除存储池内的指定节点。
注意
- 基础存储池仅剩一个可用故障域时,无法移除故障域内的任何节点。
- 节点涉及存储池的多个故障域,只能强制移除,强制移除节点可能造成数据丢失。
移除指定节点时,如果提示需要重启服务,您可以等此类操作全部执行完毕后,再重启提示信息中对应服务器上的HBlock服务。
请求语法
DELETE /rest/v1/system/storagepool/poolName/node HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization: authorization
{
"nodes": [
node1,
node2,
...
],
"force": force,
"deleteLocalData": deleteLocalData
}请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| poolName | String | 存储池名称。 取值:长度范围是1~16,只能由字母、数字和短横线(-)、下划线(_)组成,字母区分大小写,且仅支持以字母和数字开头。 | 是 |
| nodes | Array of String | 要移除的节点。一次可以移除多个同一故障域的节点。一次不能移除涉及多个故障域的节点。 | 是 |
| force | Boolean | 是否强制移除存储池内的节点。 注意 强制将节点从存储池中移除,可能造成数据丢失。 取值:
默认值为false。 | 否 |
| deleteLocalData | Boolean | 将节点从存储池移除,是否删除存储在该节点上的HBlock数据。 取值:
默认值为false。 | 否 |
请求示例
移除存储池pool1内的节点。
DELETE /rest/v1/system/storagepool/pool1/node HTTP/1.1
Date: Tue, 23 Jun 2026 06:17:33 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Content-Length: 72
Host: 192.168.0.65:1443
{
"nodes": [
"default:hblock_1:/mnt/storage01"
]
}响应示例
HTTP/1.1 202 Accepted
x-hblock-request-id: 38f23ebfb0d04bdaa528af59ab3d7b57
Connection: keep-alive
Content-Length: 11
Date: Tue, 23 Jun 2026 06:17:33 GMT
Server: HBlock
{
"data": {}
}