此操作用来从HBlock集群中移除服务器。
注意
- 如果移除服务器上有Target，该Target对应卷的高可用类型是ActiveStandby，移除服务器时，业务不会中断，此卷对应的Target会切换到其他服务器上，客户端需要重新连接Target对应的新服务器IP。
- 如果移除服务器上有Target，该Target对应卷的高可用类型是Disabled，移除服务器时，业务会中断，此卷对应的Target会切换到其他服务器上，客户端需要重新连接Target对应的新服务器IP。但服务器移除时，会有数据丢失风险。
- 如果执行日志采集后，产生的日志保存在服务器安装目录下，在服务器移除之后，该日志将被删除。如果产生的日志保存在HBlock的数据目录内，并且deleteLocalData为true，该日志也将被删除。
- 有服务器正在移除时，不能再移除其他服务器。如果必须移除，请使用强制移除，但有丢数据风险。
- 该节点的所有数据目录不属于任何存储池，允许移除该服务器。否则不能移除，如果必须移除，请使用强制移除，但有丢数据风险。
- 如果要移除服务器的某个数据目录属于基础存储池，且是基础存储池中仅剩的一个可用故障域中的节点，不允许移除。
请求语法
DELETE /rest/v1/system/server/serverId?force=force&deleteLocalData=deleteLocalData HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| serverId | String | 要移除服务器的服务器ID。 | 是 |
| force | Boolean | 是否强制移除服务器。 注意 强制移除服务器，可能造成数据丢失。 取值：
默认值为false。 | 否 |
| deleteLocalData | Boolean | 移除服务器时，是否删除服务器上HBlock数据目录中的数据。 取值：
默认值为false。 | 否 |
响应结果
| 名称 | 类型 | 描述 |
|---|---|---|
| luns | Array of lun | 被移除服务器上卷的属性信息集合，包含：lunName、iSCSITargets。详见“表1 响应参数lun说明”。 |
表1 响应参数lun说明
| 名称 | 类型 | 描述 |
|---|---|---|
| lunName | String | 被移除服务器上的卷名称。 |
| iSCSITargets | Array of iSCSITarget | 被移除服务器上卷对应的iSCSI Target属性集合。包含：iqn、status、ips，详见“表2 响应参数iSCSITarget说明”。 |
2 响应参数iSCSITarget说明
| 名称 | 类型 | 描述 |
|---|---|---|
| iqn | String | 被移除服务器上的卷对应的新Target IQN。 |
| status | String | 被移除服务器上的卷对应的Target的状态：
|
| ips | Array of ip | 被移除服务器上卷对应iSCSI Target的IP属性集合，详见“表3 响应参数ip说明”。 |
表3 响应参数ip说明
| 名称 | 类型 | 描述 |
|---|---|---|
| ip | String | 被移除服务器上的卷对应的新iSCSI Target的IP。 |
| port | Integer | 被移除服务器上的卷对应的新的iSCSI Target的端口号。 |
请求示例
移除服务器hblock_4。
DELETE /rest/v1/system/server/hblock_4?force=false&deleteLocalData=false HTTP/1.1
Date: Thu, 17 Mar 2022 02:16:39 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.121:1443响应示例
HTTP/1.1 202 Accepted
x-hblock-request-id: a1546d76c10a4758ae4b19f7fe140a02
Connection: keep-alive
Content-Length: 276
Date: Thu, 17 Mar 2022 02:16:42 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"luns": [
{
"lunName": "lun4",
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target4.15",
"status": "Offline",
"ips": [
{
"ip": "192.168.0.72",
"port": 3260
}
]
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target4.16",
"status": "Standby",
"ips": [
{
"ip": "192.168.0.121",
"port": 3260
}
]
}
]
}
]
}
}
