此操作用來設置iSCSI target的允許訪問列表。
請求語法
PUT /rest/v1/block/target/targetName/allowlist HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization: authorization
{
"iqns": [iqn,iqn,...],
"action": action,
"initiator": [
{
"IPs": [ip,ip,...],
"names": [name,name,...]
},
{
"IPs": [ip,ip,...],
"names": [name,name,...]
},
......
],
"target": [
{
"IPs": [ip,ip,...],
"NICs": [NIC,NIC,...]
},
{
"IPs": [ip,ip,...],
"NICs": [NIC,NIC,...]
},
......
]
}請求參數
| 參數 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| targetName | String | iSCSI target名稱。 取值：長度范圍是1~16，可以由小寫字母、數字、句點（.）和短橫線（-）組成，且僅支持以字母或數字開頭。 | 是 |
| iqns | Array of string | 指定target IQN名稱。 如果指定了target IQN名稱，則代表對target下指定的IQN置訪問權限；如果未指定target IQN名稱，則代表對target下所有IQN進行設置訪問權限。 | 否 |
| action | String | 設置iSCSI target的訪問權限。 取值：
| 是 |
| initiator | Array of initiator | 指定iSCSI發起方（initiator）允許訪問列表。可以設置多組initiator允許訪問列表，各組允許訪問列表之間為“或”的關系。每組允許訪問列表可以同時指定IP和initiator名稱，二者為“與”的關系。詳見“表1 參數initiator說明”。 注意 注意：
| 否 |
| target | Array of target | 指定目標端（target）的允許訪問列表。可以設置多組target允許訪問列表，各組允許訪問列表之間為“或”的關系。每組允許訪問列表可以同時指定IP和NIC名稱，二者為“與”的關系。詳見“表2 參數target說明”。 注意 注意：
| 否 |
表1 參數initiator說明
| 參數 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| IPs | Array of ip | 根據initiator IP地址設置iSCSI發起方的允許訪問列表。 取值：IPv4、IPv6、CIDR子網，可以設置多個，以英文逗號分隔。如果設置"IPs":[]，表示禁止所有發起端進行訪問。 注意 IP不能為localhost。 | 否 |
| names | Array of name | 根據initiator名稱設置iSCSI發起方的允許訪問列表。 取值：字符串形式，長度范圍是1~223，只能由字母、數字、句點( . )、短橫線( - )、冒號( : )組成，字母區分大小寫。支持通配符*和?。可以設置多個，以英文逗號分隔。如果設置"names":[]，表示禁止所有發起端進行訪問。 | 否 |
表2 參數target說明
| 參數 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| IPs | Array of ip | 通過target端IP進行設置target允許訪問列表，表示只允許通過target端的指定IP訪問target。 取值：IPv4、IPv6、CIDR子網，可以設置多個，以英文逗號分隔。如果設置"IPs":[]，表示禁止通過target端進行訪問。 注意 IP不能為localhost。 | 否 |
| NICs | Array of NIC | 通過target端的網卡名稱設置target允許訪問列表，表示只允許通過target端的指定網卡訪問target。 取值：target端的網卡名稱，可包含字母、數字、句點(.)、短橫線(-)和下劃線(_)，最多100個字符。支持通配符*和?。可以設置多個，以英文逗號分隔。如果設置"NICs":[]，表示禁止通過target端進行訪問。 | 否 |
請求示例
為target07增加允許訪問列表。
PUT /rest/v1/block/target/target07/allowlist HTTP/1.1
Date: Mon, 18 Aug 2025 03:03:52 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Content-Length: 636
Host: 192.168.0.64:1443
{
"action": "add",
"initiator": [
{
"IPs": [
"192.168.0.70"
],
"names": [
"iqn.1991-05.com.microsoft:songt-0001"
]
},
{
"IPs": [
"192.168.0.66"
]
}
],
"target": [
{
"IPs": [
"192.168.0.64",
"192.168.0.67"
]
},
{
"IPs": [
"192.168.0.65"
],
"NICs": [
"eth0"
]
}
]
}響應示例
HTTP/1.1 204 No Content
x-hblock-request-id: db9d71cdd4c342ea895cd71efe66482a
Connection: keep-alive
Date: Mon, 18 Aug 2025 03:03:52 GMT
Server: HBlock
