此操作用來修改服務器屬性。
說明
后續新增的數據服務端口會從修改后的端口范圍中選擇，已使用的端口值不變。
注意
修改端口范圍（portRange）時，請避免和Linux系統的本地臨時端口（ip_local_port_range）范圍重合，否則可能會導致HBlock服務所用的端口被占用。使用命令行cat /proc/sys/net/ipv4/ip_local_port_range可以查看本地臨時端口范圍。
請求語法
PUT /rest/v1/system/server/serverId HTTP/1.1
Date:date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization:authorization
{
"targetPortalIP": {
"ips": [
{
"ip": ip,
"port": port,
}
],
"status": status
},
"defaultPath": defaultPath,
"portRange": port1-port2
}請求參數
| 參數 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| serverId | String | 要修改的服務器ID。 | 是 |
| targetPortalIP.ips | Array of ip | iSCSI目標門戶IP屬性集合，詳見“表1 請求參數targetPortalIP.ip說明”。 說明 若服務器與客戶端不在同一網段（如服務器位于內網，客戶端位于外網），通過NAT設備（如路由器）進行連接，則需要將NAT設備的外網地址和端口添加到服務器，從而使得外網的客戶端可以正常與該服務器的target建立iSCSI連接。 | 否 |
| targetPortalIP.status | String | 是否啟用iSCSI目標門戶IP。 取值：
| 是 |
| defaultPath | String | 設置默認的數據目錄（僅單機版本支持）。 數據目錄必須是已經添加到HBlock系統中，并且狀態為Normal的數據目錄。 | 否 |
| portRange | String | 指定端口范圍，用于相關服務。 取值：整型，取值范圍為[1, 65535]，port1為端口范圍最小值，port2為端口范圍最大值，且port1 < port2。 說明 建議指定的端口范圍至少包含500個端口。 | 否 |
表1 請求參數targetPortalIP.ip說明
| 參數 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| ip | String | iSCSI目標門戶IP。 說明 ip和port必須同時存在，或者同時不存在。 | 否 |
| port | Integer | iSCSI目標門戶端口號。 說明 ip和port必須同時存在，或者同時不存在。 取值：[1, 65535]。 | 否 |
請求示例1
單機版：修改服務器hblock_1的iSCSI目標門戶IP和端口修改為：10.1.0.1和101，設置默認數據目錄為：/mnt/storage01。
PUT /rest/v1/system/server/hblock_1 HTTP/1.1
Date: Fri, 29 Jul 2022 09:12:25 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Content-Length: 270
Host: 192.168.0.69:1443
{
"targetPortalIP": {
"ips":[
{
"ip":"10.1.0.1",
"port":"101"
}
],
"status":"Enabled"
},
"defaultPath":"/mnt/storage01"
}響應示例1
HTTP/1.1 204 No Content
x-hblock-request-id: facb844a44034035bd9254c7d901cfac
Connection: keep-alive
Date: Fri, 29 Jul 2022 09:12:25 GMT
Server: HBlock請求示例2
集群版：修改服務器hblock_1的iSCSI目標門戶IP和端口修改為：10.1.0.1和101。
PUT /rest/v1/system/server/hblock_1 HTTP/1.1
Date: Fri, 29 Jul 2022 09:00:33 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Content-Length: 221
Host: 192.168.0.121:1443
{
"targetPortalIP": {
"ips":[
{
"ip":"10.1.0.1",
"port":"101"
}
],
"status":"Enabled"
}
}響應示例2
HTTP/1.1 204 No Content
x-hblock-request-id: cbe33ebab9ad46df9fe691b71585e230
Connection: keep-alive
Date: Fri, 29 Jul 2022 09:00:33 GMT
Server: HBlock請求示例3
修改服務器hblock_1的端口范圍為19500-20500。
PUT /rest/v1/system/server/hblock_1 HTTP/1.1
Date: Tue, 26 Sep 2023 06:45:38 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Content-Length: 39
Host: 192.168.0.121:1443
{
"portRange":"19500-20500"
}響應示例3
HTTP/1.1 204 No Content
x-hblock-request-id: 2271ef7c175c44cca2e197c12f2cb742
Connection: keep-alive
Date: Tue, 26 Sep 2023 06:45:38 GMT
Server: HBlock
