此操作用来修改服务器属性。
说明
后续新增的数据服务端口会从修改后的端口范围中选择，已使用的端口值不变。
注意
修改端口范围（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属性集合，包含：ip、port，详见“表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
