此操作用来批量查询卷。可以通过设置过滤条件和range范围进行查询。如果未设置过滤条件和range范围，则查询所有的卷。
请求语法
GET /rest/v1/block/lun?filter=filter&range=i-j HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization请求参数
| 参数 | 描述 | 是否必须 |
|---|---|---|
| filter | 查询的过滤条件。可以选择多个查询，如果是或的关系，使用“or”将查询条件分隔开；如果是与的关系，使用“and”将查询条件分隔开。 支持的过滤条件类型包括：
| 否 |
| range | 查询卷的范围，格式为i-j，i和j为正整数，0 < j-i < 1000。按照卷名称进行排序，返回第i到第j的卷。如果输入的查询范围超过卷的总个数，返回的结果为空，如果未指定range，则返回所有符合条件的卷。 | 否 |
响应结果
| 名称 | 描述 |
|---|---|
| lunName | 卷名称。 |
| status | 卷的状态：
|
| recoverFailedReason | 卷还原失败的原因。 仅卷状态为RecoverFailed时显示。 |
| deleteFailedReason | 卷云上数据删除失败的原因。 仅卷状态为DeleteFailed时显示。 |
| storageMode | 卷的存储类型：
|
| capacity | 卷容量，单位是GiB。 |
| createTime | 卷创建时间。unix时间戳（UTC），精确到毫秒。 |
| iSCSITargets | iSCSITargets iSCSI Target属性集合。包含：iqn、status、ips、serverId。 类型：数组 |
| iqn | iSCSI Target IQN。 |
| iSCSITargets.status | 卷对应的Target的状态：
|
| ips | iSCSI Target的IP属性集合，包含：ip、port。 类型：数组 |
| ip | iSCSI Target的IP。 |
| port | iSCSI Target的端口号。 |
| serverId | IQN所在的服务器ID。 |
| cloud.bucketName | OOS存储桶的名称（仅上云卷支持）。 |
| cloud.endpoint | OOS Endpoint（仅上云卷支持）。 |
| cloud.signVersion | 上云签名认证的类型（仅上云卷支持）：
|
| cloud.region | Endpoint资源池所在区域（仅上云卷支持）。 |
| cloud.provider | 对象存储服务名称：
|
| config.minReplica | 卷的最小副本数（仅集群版支持）。 |
| config.ECfragmentSize | 分片大小。如果冗余模式为EC N+M，则会返回此项。 |
| config.sectorSize | 扇区大小：
|
| config.highAvailability | 高可用模式类型（仅集群版支持）：
|
| config.writePolicy | 卷的写策略：
|
| config.cachePool | 缓存存储池（仅集群版支持）。 |
| config.pool | 存储池（仅集群版支持），表示最终存储池，卷数据最终落在该存储池内。 |
| config.redundancyOverlap | 卷的折叠副本数（仅集群版支持）。 |
| config.serverAffinity.autoFailback | 针对卷主备状态，当高优先级的服务器恢复正常后，是否自动进行主备状态切换（仅集群版支持）：
|
| config.serverAffinity.priority | 卷主备分布优先级的服务器ID（仅集群版支持），根据系统指定的服务器ID顺序来选择卷的主备IQN。 |
| config.path | 数据目录（仅单机版支持）。 |
| number | 卷编号。 |
| WWID | 卷的唯一标识符。 |
请求示例1
单机版：查询卷名称包含lunb或lunc的卷，且状态为Enabled的卷。
GET /rest/v1/block/lun?filter=lunName:lunb or lunName:lunc and status:Enabled HTTP/1.1
Date: Fri, 03 Jan 2025 03:22:03 GMT
Authorization: userName:signature
Host: 192.168.0.32:1443
响应示例1
HTTP/1.1 200 OK
x-hblock-request-id: 04521019519844689f4051424b170aaf
Connection: keep-alive
Content-Length: 1593
Date: Fri, 03 Jan 2025 03:22:03 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"luns": [
{
"lunName": "lunb1",
"status": "Enabled",
"capacity": 230,
"storageMode": "Cache",
"createTime": 1734407368558,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:targetb.2",
"status": "Active",
"ips": [
{
"ip": "192.168.0.32",
"port": 3260
}
],
"serverId": "hblock_1"
}
],
"cloud": {
"bucketName": "hblocktest3",
"endpoint": "https://oos-cn.ctyunapi.cn",
"signVersion": "v4",
"region": "cn",
"provider": "OOS"
},
"config": {
"sectorSize": 4096,
"writePolicy": "WriteBack",
"path": "/mnt/stor"
},
"number": 0,
"WWID": "3300000002f3e892d"
},
{
"lunName": "lunb3",
"status": "Enabled",
"capacity": 299,
"storageMode": "Local",
"createTime": 1735176509888,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:targetb.2",
"status": "Active",
"ips": [
{
"ip": "192.168.0.32",
"port": 3260
}
],
"serverId": "hblock_1"
}
],
"config": {
"sectorSize": 4096,
"writePolicy": "WriteBack",
"path": "/mnt/stor"
},
"number": 2,
"WWID": "3300000006b0fed64"
},
{
"lunName": "lunb4",
"status": "Enabled",
"capacity": 333,
"storageMode": "Local",
"createTime": 1735176585689,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:targetb.2",
"status": "Active",
"ips": [
{
"ip": "192.168.0.32",
"port": 3260
}
],
"serverId": "hblock_1"
}
],
"config": {
"sectorSize": 4096,
"writePolicy": "WriteBack",
"path": "/mnt/stor"
},
"number": 3,
"WWID": "3300000006346a3f7"
},
{
"lunName": "lunc2",
"status": "Enabled",
"capacity": 30,
"storageMode": "Local",
"createTime": 1735176602182,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:targetc.3",
"status": "Active",
"ips": [
{
"ip": "192.168.0.32",
"port": 3260
}
],
"serverId": "hblock_1"
}
],
"config": {
"sectorSize": 4096,
"writePolicy": "WriteBack",
"path": "/mnt/stor"
},
"number": 1,
"WWID": "33ffffffff1b6f1c9"
}
]
}
}
请求示例2
集群版：查询卷名称包含lun的卷，并且只列出第1个到第3个查询结果。
GET /rest/v1/block/lun?filter=lunName:lun&range=1-3 HTTP/1.1
Date: Fri, 03 Jan 2025 06:24:53 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.192:1443
响应示例2
HTTP/1.1 200 OK
x-hblock-request-id: ff61c214073f47e6a1dde46272677fea
Connection: keep-alive
Content-Length: 2268
Date: Fri, 03 Jan 2025 06:24:53 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"luns": [
{
"lunName": "lun01a",
"status": "Enabled",
"capacity": 100,
"storageMode": "Local",
"createTime": 1735875169673,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.2",
"status": "Active",
"ips": [
{
"ip": "192.168.0.202",
"port": 3260
}
],
"serverId": "hblock_2"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.1",
"status": "Standby",
"ips": [
{
"ip": "192.168.0.102",
"port": 3260
}
],
"serverId": "hblock_3"
}
],
"config": {
"localStorageClass": "EC 2+1",
"minReplica": 2,
"sectorSize": 4096,
"highAvailability": "ActiveStandby",
"writePolicy": "WriteBack",
"pool": "default",
"redundancyOverlap": 1,
"serverAffinity": {
"autoFailback": "Enabled",
"priority": [
"hblock_2"
]
},
"ECfragmentSize": 16
},
"number": 0,
"WWID": "3300000000aa369a3"
},
{
"lunName": "lun02a",
"status": "Enabled",
"capacity": 200,
"storageMode": "Cache",
"createTime": 1735875228560,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target02.3",
"status": "Active",
"ips": [
{
"ip": "192.168.0.192",
"port": 3260
}
],
"serverId": "hblock_1"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target02.4",
"status": "Standby",
"ips": [
{
"ip": "192.168.0.102",
"port": 3260
}
],
"serverId": "hblock_3"
}
],
"cloud": {
"bucketName": "hblocktest3",
"endpoint": "https://oos-cn.ctyunapi.cn",
"signVersion": "v2",
"provider": "OOS"
},
"config": {
"localStorageClass": "EC 2+1",
"minReplica": 2,
"sectorSize": 4096,
"highAvailability": "ActiveStandby",
"writePolicy": "WriteBack",
"pool": "default",
"redundancyOverlap": 1,
"serverAffinity": {
"autoFailback": "Enabled"
},
"ECfragmentSize": 16
},
"number": 0,
"WWID": "33fffffff9000b000"
},
{
"lunName": "lun03a",
"status": "Enabled",
"capacity": 300,
"storageMode": "Storage",
"createTime": 1735875276924,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target03.5",
"status": "Active",
"ips": [
{
"ip": "192.168.0.202",
"port": 3260
}
],
"serverId": "hblock_2"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target03.6",
"status": "Standby",
"ips": [
{
"ip": "192.168.0.192",
"port": 3260
}
],
"serverId": "hblock_1"
}
],
"cloud": {
"bucketName": "hblocktest3",
"endpoint": "https://oos-cn.ctyunapi.cn",
"signVersion": "v4",
"region": "cn",
"provider": "OOS"
},
"config": {
"localStorageClass": "EC 2+1",
"minReplica": 2,
"sectorSize": 4096,
"highAvailability": "ActiveStandby",
"writePolicy": "WriteBack",
"pool": "default",
"redundancyOverlap": 1,
"serverAffinity": {
"autoFailback": "Enabled"
},
"ECfragmentSize": 16
},
"number": 0,
"WWID": "3300000002d28e800"
}
]
}
}
