查詢指定的iSCSI target
更新時間 2025-09-29 17:49:38
最近更新時間: 2025-09-29 17:49:38
分享文章
本節主要介紹如何使用API查詢指定的iSCSI target。
此操作用來查詢指定的iSCSI target。
請求語法
GET /rest/v1/block/target/targetName HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization請求參數
| 參數 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| targetName | String | iSCSI target名稱。 說明 如果不填寫此項,會返回所有target信息。 取值:長度范圍是1~16,可以由小寫字母、數字、句點(.)和短橫線(-)組成,且僅支持以字母或數字開頭。 | 否 |
響應結果
| 名稱 | 類型 | 描述 |
|---|---|---|
| targetName | String | iSCSI target名稱。 |
| maxSessions | Integer | iSCSI target下每個IQN允許建立的最大會話數。 |
| iSCSITargets | Array of iSCSITarget | iSCSI target屬性集合,詳見“表1 響應參數iSCSITarget說明”。 |
| luns | Array of lun | 關聯卷的屬性,詳見“表7 響應參數lun說明”。 |
| chap.name | String | CHAP認證名稱。 |
| chap.status | String | CHAP認證狀態:
|
| createTime | Long | 創建iSCSI target的時間,unix時間戳(UTC),精確到毫秒。 |
| serverIds | Array of string | iSCSI target對應的服務器ID(僅集群版支持)。 |
| num | Integer | target所在的服務器數量(僅集群版支持)。 |
| reclaimPolicy | String | iSCSI target的回收策略:
|
| status | String | iSCSI target的狀態:
僅iSCSI target處于刪除中會返回此項。 |
表1 響應參數iSCSITarget說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| iqn | String | iSCSI target IQN。 |
| ips | Array of ip | iSCSI target的IP屬性集合,包含: ip、port,詳見“表2 響應參數ip說明”。 |
| targetPortalIP | Object | iSCSI目標門戶,詳見“表3 響應參數targetPortalIP說明”。 |
| serverId | String | iSCSI target的IQN所在的服務器ID。 |
| allowlist.initiator | Array of initiator | iSCSI發起方(initiator)允許訪問列表。詳見“表5 響應參數initiator說明”。 |
| allowlist.target | Array of target | 目標端(target)的允許訪問列表。詳見“表6 響應參數target說明”。 |
表2 響應參數ip說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| ip | String | iSCSI target的IP。 |
| port | Integer | iSCSI target的端口號。 |
表3 響應參數targetPortalIP說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| ips | Array of ip | iSCSI目標門戶的IP屬性集合,詳見“表4 響應參數targetPortalIP.ip說明”。 |
| targetPortalIP.status | String | iSCSI目標門戶IP狀態:
說明 如果未配置,不返回該項。 |
表4 響應參數ip(iSCSI目標門戶的IP)說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| ip | String | iSCSI目標門戶IP。 |
| port | Integer | iSCSI目標門戶端口號。 |
表5 響應參數initiator說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| IPs | Array of ip | 根據initiator IP地址設置的iSCSI發起方允許訪問列表。 |
| names | Array of name | 根據initiator名稱設置的iSCSI發起方允許訪問列表。 |
表6 響應參數target說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| IPs | Array of ip | 通過target端IP進行設置的target允許訪問列表,表示只允許通過target端的指定IP訪問target。 |
| NICs | Array of NIC | 通過target端的網卡名稱設置的target允許訪問列表,表示只允許通過target端的指定網卡訪問target。 |
表7 響應參數lun說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| lunName | String | 關聯卷的名稱。 |
| number | Integer | 卷編號。 |
請求示例1
單機版:查詢iSCSI target名稱為targeta的信息。
GET /rest/v1/block/target/targeta HTTP/1.1
Date: Mon, 08 Sep 2025 01:29:15 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.32:1443
Connection: keep-alive響應示例1
HTTP/1.1 200 OK
x-hblock-request-id: e66f2a16825240009d3de70b158ad161
Connection: keep-alive
Content-Length: 478
Date: Mon, 08 Sep 2025 01:29:15 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"targetName": "targeta",
"maxSessions": 3,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:targeta.1",
"ips": [
{
"ip": "192.168.0.66",
"port": 3260
}
],
"serverId": "hblock_1",
"allowlist": {
"initiator": [
{
"names": [
"iqn.1994-05.com.redhat:c73bf5e45bd4"
],
"IPs": [
"192.168.0.68"
]
},
{
"IPs": [
"192.168.0.70"
]
}
],
"target": [
{
"IPs": [
"192.168.0.66"
]
}
]
}
}
],
"luns": [
{
"lunName": "luna1",
"number": 0
},
{
"lunName": "luna1-clone1",
"number": 1
}
],
"createTime": 1754375366254,
"num": 1,
"reclaimPolicy": "Delete"
}
}請求示例2
集群版:查詢iSCSI target名稱為target03的信息。
GET /rest/v1/block/target/target03 HTTP/1.1
Date: Thu, 24 Jul 2025 08:36:15 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.64:1443
Connection: keep-alive響應示例2
HTTP/1.1 200 OK
x-hblock-request-id: b859187a66164328b538bc421c2861da
Connection: keep-alive
Content-Length: 1096
Date: Thu, 24 Jul 2025 08:36:15 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"targetName": "target03",
"maxSessions": 2,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target03.5",
"ips": [
{
"ip": "192.168.0.67",
"port": 3260
}
],
"serverId": "hblock_3",
"allowlist": {
"initiator": [
{
"names": [
"iqn.1991-05.com.microsoft:songt-0001"
],
"IPs": [
"192.168.0.70"
]
},
{
"IPs": [
"192.168.0.66"
]
}
],
"target": [
{
"IPs": [
"192.168.0.64"
]
},
{
"IPs": [
"192.168.0.65"
]
},
{
"IPs": [
"192.168.0.67"
]
},
{
"IPs": [
"192.168.0.64",
"192.168.0.65",
"192.168.0.67"
]
},
{
"IPs": [
"192.168.0.71"
]
}
]
}
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target03.6",
"ips": [
{
"ip": "192.168.0.65",
"port": 3260
}
],
"serverId": "hblock_1",
"allowlist": {
"initiator": [
{
"names": [
"iqn.1991-05.com.microsoft:songt-0001"
],
"IPs": [
"192.168.0.70"
]
},
{
"IPs": [
"192.168.0.66"
]
}
],
"target": [
{
"IPs": [
"192.168.0.64"
]
},
{
"IPs": [
"192.168.0.65"
]
},
{
"IPs": [
"192.168.0.67"
]
},
{
"IPs": [
"192.168.0.64",
"192.168.0.65",
"192.168.0.67"
]
},
{
"IPs": [
"192.168.0.71"
]
}
]
}
}
],
"luns": [
{
"lunName": "lun03a",
"number": 0
},
{
"lunName": "lun03b",
"number": 1
}
],
"chap": {
"name": "chap-test",
"status": "Disabled"
},
"createTime": 1752111720420,
"serverIds": [
"hblock_1",
"hblock_3"
],
"num": 2,
"reclaimPolicy": "Delete"
}
}