查询iSCSI target的连接信息
更新时间 2026-03-27 17:21:40
最近更新时间: 2026-03-27 17:21:40
本节主要介绍如何使用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名称为target01的连接信息。
GET /rest/v1/block/connection/?filter=targetName::target01 HTTP/1.1
Date: Fri, 27 Mar 2026 08:57:09 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Host:192.168.0.65:1443 响应示例
HTTP/1.1 200 OK
x-hblock-request-id: 631a52fa43544b2bbdbba088f9d5f645
Connection: keep-alive
Content-Length: 678
Date: Fri, 27 Mar 2026 08:57:09 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"connections": [
{
"targetName": "target01",
"targetConnections": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.5",
"targetIP": "192.168.0.65",
"establishedSessions": 1,
"sessionDetails": [
{
"sessionId": "0xf159",
"clientIP": "192.168.0.69",
"clientPort": 59169,
"initiatorName": "iqn.1991-05.com.microsoft:songt-0008"
}
]
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.6",
"targetIP": "192.168.0.64",
"establishedSessions": 2,
"sessionDetails": [
{
"sessionId": "0x12f",
"clientIP": "192.168.0.70",
"clientPort": 54870,
"initiatorName": "iqn.1991-05.com.microsoft:songt-0001"
},
{
"sessionId": "0xffe9",
"clientIP": "192.168.0.69",
"clientPort": 59170,
"initiatorName": "iqn.1991-05.com.microsoft:songt-0008"
}
]
}
]
}
]
}
}
