此操作用来批量查询iSCSI Target。
请求语法
GET /rest/v1/block/target?filter=filter&range=i-j HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization
请求参数
参数 描述 是否必须 filter 查询的过滤条件。可以选择多个查询，如果是或的关系，使用or将查询条件分隔开；如果是与的关系，使用and将查询条件分隔开。
支持的过滤条件类型包括：
lunName：iSCSI Target关联的卷名称。
targetName：iSCSI Target名称。
iqn：iSCSI Target IQN。
否 range 查询iSCSI Target的范围，格式为i-j，i和j为正整数，0 < j-i < 1000。按照Target名称进行排序，返回第i到第j的Target。
如果输入的查询范围超过iSCSI Target的总个数，返回的结果为空，如果未指定range，则返回所有符合条件的iSCSI Target。
否
响应结果
名称 描述 targetName iSCSI Target名称。 maxSessions iSCSI Target下每个IQN允许建立的最大会话数。 iSCSITargets iSCSI Target属性集合。包含：iqn、ips、targetPortalIP、serverId。
类型：数组
iqn iSCSI Target IQN。 ips iSCSI Target的IP属性集合，包含：ip、port。
类型：数组
ip iSCSI Target的IP。 port iSCSI Target的端口号。 targetPortalIP.ips iSCSI目标门户IP属性集合，包含：ip、port。
类型：数组
ip iSCSI目标门户IP。
说明如果未配置，不返回该项。
port iSCSI目标门户端口号。
说明如果未配置，不返回该项。
targetPortalIP.status iSCSI目标门户IP状态：
Enabled：启用状态。
Disabled：停用状态。
说明如果未配置，不返回该项。
serverId iSCSI Target的IQN所在的服务器ID。 chap.name CHAP认证名称。 chap.status CHAP认证状态：
Enabled：启用CHAP认证。
Disabled：禁用CHAP认证。
createTime 创建iSCSI Target的时间，unix时间戳（UTC），精确到毫秒。 serverIds iSCSI Target对应的服务器ID（仅集群版支持）。 num Target所在的服务器数量（仅集群版支持）。
请求示例1
单机版：查询iSCSI Target名称中包含target，且关联的卷名称包含lun的iSCSI Target，且只列出第1个到第100个的查询结果。
GET /rest/v1/block/target?filter=targetName:target and lunName:lun&range=1-100 HTTP/1.1
Date: Thu, 28 Sep 2023 09: 10: 40 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.32: 1443
响应示例1
HTTP/1.1 200 OK
x-hblock-request-id: afa77ab80a234f31bc6e58d9512cae99
Connection: keep-alive
Content-Length: 637
Date: Thu, 28 Sep 2023 09: 10: 40 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"targets": [
{
"targetName": "targeta",
"maxSessions": 1,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:targeta.2",
"ips": [
{
"ip": "192.168.0.32",
"port": 3260
}
],
"targetPortalIP": {
"ips": [
{
"ip": "10.1.1.10",
"port": 20430
}
],
"status": "Disabled"
},
"serverId": "hblock_1"
}
],
"createTime": 1695891789350,
"num": 1
},
{
"targetName": "targetc",
"maxSessions": 3,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:targetc.1",
"ips": [
{
"ip": "192.168.0.32",
"port": 3260
}
],
"targetPortalIP": {
"ips": [
{
"ip": "10.1.1.10",
"port": 20430
}
],
"status": "Disabled"
},
"serverId": "hblock_1"
}
],
"chap": {
"name": "chap-test",
"status": "Enabled"
},
"createTime": 1695806964763,
"num": 1
}
]
}
}
请求示例2
集群版：查询iSCSI Target名称中包含target0，且关联的卷名称包含lun0的iSCSI Target，且只列出第1个到第100个的查询结果。
GET /rest/v1/block/target?filter=targetName:target0 and lunName:lun0&range=1-100 HTTP/1.1
Date: Thu,28 Sep 2023 08: 46: 43 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.192: 1443
响应示例2
HTTP/1.1 200 OK
x-hblock-request-id: 2fe3309a0e7c4171bde34ad4923222d0
Connection: keep-alive
Content-Length: 992
Date: Thu, 28 Sep 2023 08: 46: 43 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"targets": [
{
"targetName": "target01",
"maxSessions": 10,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.3",
"ips": [
{
"ip": "192.168.0.117",
"port": 3260
}
],
"targetPortalIP": {
"ips": [
{
"ip": "10.0.1.10",
"port": 10011
}
],
"status": "Disabled"
},
"serverId": "hblock_1"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.4",
"ips": [
{
"ip": "192.168.0.102",
"port": 3260
}
],
"serverId": "hblock_2"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.5",
"ips": [
{
"ip": "192.168.0.192",
"port": 3260
}
],
"serverId": "hblock_3"
}
],
"chap": {
"name": "chap-test",
"status": "Disabled"
},
"createTime": 1695806252000,
"serverIds": [
"hblock_1",
"hblock_2",
"hblock_3"
],
"num": 3
},
{
"targetName": "target02",
"maxSessions": 1,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target02.9",
"ips": [
{
"ip": "192.168.0.110",
"port": 3260
}
],
"serverId": "hblock_4"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target02.10",
"ips": [
{
"ip": "192.168.0.192",
"port": 3260
}
],
"serverId": "hblock_3"
}
],
"createTime": 1695889887559,
"serverIds": [
"hblock_3",
"hblock_4"
],
"num": 2
}
]
}
}
