此操作用来从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
要移除服务器的服务器ID。
类型：字符串
是
force
是否强制移除服务器。
注意
强制移除服务器，可能造成数据丢失。
类型：布尔
取值：
true：是。
false：否。
默认值为false。
否
deleteLocalData
移除服务器时，是否删除服务器上HBlock数据目录中的数据。
类型：布尔
取值：
true：删除服务器上HBlock数据目录中的数据。
false：不删除服务器上HBlock数据目录中的数据。
默认值为false。
否

响应结果

名称
描述
luns
被移除服务器上卷的属性信息集合，包含：lunName、iSCSITargets。
类型：数组
lunName
被移除服务器上的卷名称。
iSCSITargets
被移除服务器上卷对应的iSCSI Target属性集合。包含：iqn、status、ips。
类型：数组
iqn
被移除服务器上的卷对应的新Target IQN。
status
被移除服务器上的卷对应的Target的状态：
Active：主Target。
Standby：热备Target。
Offline：离线Target。
Unavailable：冷备Target。
ips
被移除服务器上卷对应iSCSI Target的IP属性集合，包含：ip、port。
类型：数组
ip
被移除服务器上的卷对应的新iSCSI Target的IP。
port
被移除服务器上的卷对应的新的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
                            }
                        ]
                    }
                ]
            }
        ]
    }
}