移除服務器（集群版適用）
更新時間 2025-10-21 17:46:05
最近更新時間: 2025-10-21 17:46:05
分享文章
本節主要介紹如何使用API移除服務器（集群版適用）。
此操作用來從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
}
]
}
]
}
]
}
}
