查询iSCSI target的连接信息
更新时间 2026-08-17 09:47:42
最近更新时间: 2026-08-17 09:47:42
本节主要介绍如何使用API查询iSCSI target的连接信息。
此操作用来查询iSCSI target的连接信息。
请求语法
GET /rest/v1/block/connection/?filter=filter&range=i-j HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| filter | String | 查询的过滤条件。 过滤条件由查询属性和属性值组成，其中属性和属性值之间用单个冒号分隔（key:value）表示模糊匹配，用两个冒号分隔（key::value）表示精确匹配。可以选择多个查询，如果是或的关系，使用“or”将查询条件分隔开；如果是与的关系，使用“and”将查询条件分隔开。 支持的过滤条件类型包括：
| 否 |
| range | String | 查询iSCSI target连接的范围，格式为i-j，i和j为正整数，0 < j-i < 1000。按照iSCSI target名称进行排序，返回第i到第j的iSCSI target连接信息。 如果输入的查询范围超过iSCSI target连接的总个数，返回的结果为空，如果未指定range，则返回所有符合条件的iSCSI target连接。 | 否 |
响应结果
| 名称 | 类型 | 描述 |
|---|---|---|
| connections | Array of connection | 连接信息集合，详见“表1 响应参数connection说明”。 |
表1 响应参数connection说明
| 名称 | 类型 | 描述 |
|---|---|---|
| targetName | String | iSCSI target名称。 |
| targetConnections | Array of targetConnection | iSCSI target连接信息集合，详见“表2 响应参数targetConnection说明”。 |
表2 响应参数targetConnection说明
| 名称 | 类型 | 描述 |
|---|---|---|
| iqn | String | IQN。 |
| targetIP | String | 服务器端IP。 |
establishedSessions | Integer | 会话数。 |
| sessionDetails | Array of sessionDetail | 会话详细信息集合，详见“表3 响应参数sessionDetail说明”。 |
表3 响应参数sessionDetail说明
| 名称 | 类型 | 描述 |
|---|---|---|
| sessionId | String | 会话ID。 |
| clientIP | String | 客户端的IP。 |
| clientPort | Integer | 客户端的端口号。 |
| initiatorName | String | 连接所属的initiator名称。 |
请求示例
查询iSCSI target名称包含target的连接。
GET /rest/v1/block/connection/?filter=targetName:target HTTP/1.1
Date: Tue, 28 Jul 2026 07:48:52 GMT
Authorization: HBlock userName:signature
Host:192.168.0.65:1443 响应示例
HTTP/1.1 200 OK
x-hblock-request-id: fa9d2530e1004b1dbeb5de2ded93ddc1
Connection: keep-alive
Content-Length: 2104
Date: Tue, 28 Jul 2026 07:48:53 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"connections": [
{
"targetName": "target01",
"targetConnections": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.1",
"targetIP": "192.168.0.67",
"establishedSessions": 2,
"sessionDetails": [
{
"sessionId": "0xa3ce",
"clientIP": "192.168.0.70",
"clientPort": 51029,
"initiatorName": "iqn.1991-05.com.microsoft:songt-0001"
},
{
"sessionId": "0xd5e",
"clientIP": "192.168.0.69",
"clientPort": 53106,
"initiatorName": "iqn.1991-05.com.microsoft:songt-0008"
}
]
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.2",
"targetIP": "192.168.0.64",
"establishedSessions": 2,
"sessionDetails": [
{
"sessionId": "0x5269",
"clientIP": "192.168.0.70",
"clientPort": 51031,
"initiatorName": "iqn.1991-05.com.microsoft:songt-0001"
},
{
"sessionId": "0x735",
"clientIP": "192.168.0.69",
"clientPort": 53118,
"initiatorName": "iqn.1991-05.com.microsoft:songt-0008"
}
]
}
]
},
{
"targetName": "target02",
"targetConnections": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target02.3",
"targetIP": "192.168.0.65",
"establishedSessions": 1,
"sessionDetails": [
{
"sessionId": "0x8237",
"clientIP": "192.168.0.69",
"clientPort": 53119,
"initiatorName": "iqn.1991-05.com.microsoft:songt-0008"
}
]
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target02.4",
"targetIP": "192.168.0.67",
"establishedSessions": 1,
"sessionDetails": [
{
"sessionId": "0xdbe",
"clientIP": "192.168.0.69",
"clientPort": 53120,
"initiatorName": "iqn.1991-05.com.microsoft:songt-0008"
}
]
}
]
},
{
"targetName": "target03",
"targetConnections": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target03.5",
"targetIP": "192.168.0.65",
"establishedSessions": 1,
"sessionDetails": [
{
"sessionId": "0x823d",
"clientIP": "192.168.0.69",
"clientPort": 53121,
"initiatorName": "iqn.1991-05.com.microsoft:songt-0008"
}
]
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target03.6",
"targetIP": "192.168.0.64",
"establishedSessions": 1,
"sessionDetails": [
{
"sessionId": "0x748",
"clientIP": "192.168.0.69",
"clientPort": 53124,
"initiatorName": "iqn.1991-05.com.microsoft:songt-0008"
}
]
}
]
},
{
"targetName": "target04",
"targetConnections": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target04.7",
"targetIP": "192.168.0.65",
"establishedSessions": 0
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target04.8",
"targetIP": "192.168.0.67",
"establishedSessions": 0
}
]
}
]
}
}
