此操作用来查询指定卷。
请求语法
GET /rest/v2/block/lun/lunName HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| lunName | String | 卷名称。 说明 如果不填写此项,会返回所有卷信息。 取值:长度范围是1~16,只能由字母、数字和短横线(-)组成,字母区分大小写,且仅支持以字母或数字开头。 | 否 |
响应结果
| 名称 | 类型 | 描述 |
|---|---|---|
| lunName | String | 卷名称。 |
| targetName | String | target名称。 |
| status | String | 卷的状态:
|
| progress | Double | 卷还原进度百分比。 仅卷状态为Recovering时显示。 |
| recoverFailedReason | String | 卷还原失败的原因。 仅卷状态为RecoverFailed时显示。 |
| deleteFailedReason | String | 卷云上数据删除失败的原因。 仅卷状态为DeleteFailed时显示。 |
| wipeFailedReason | String | 卷清空失败的原因。 仅卷状态为WipeFailed时显示。 |
| waitUploadBytes | String | 待上传数据量,单位是bytes。 仅卷状态为Suspending时显示。 |
| SuspendFailedReason | String | 卷挂起失败的原因。 仅卷状态为SuspendFailed时显示。 |
| capacity | Integer | 卷容量,单位是GiB。 |
| storageMode | String | 卷的存储类型:
|
| createTime | Long | 卷创建时间。unix时间戳(UTC),精确到毫秒。 |
| iSCSITargets | Array of iSCSITarget | iSCSI target属性集合,详见“表1 响应参数iSCSITarget说明”。 |
| cloud.bucketName | String | 存储桶的名称(仅上云卷支持)。 |
| cloud.prefix | String | 对象存储中的前缀名称(仅上云卷支持)。 如果未设置,则不返回此项。 |
| cloud.accessKey | String | 对象存储服务的Access Key(仅上云卷支持)。 |
| cloud.endpoint | String | 对象存储Endpoint(仅上云卷支持)。 |
| cloud.objectSize | Integer | 数据存储在对象存储的大小(仅上云卷支持)。 |
| cloud.storageClass | String | 数据在对象存储的存储类型(仅上云卷支持):
|
| cloud.compression | String | 是否压缩数据上传至对象存储(仅上云卷支持):
|
| cloud.signVersion | String | 上云签名认证的类型(仅上云卷支持):
|
| cloud.region | String | Endpoint资源池所在区域(仅上云卷支持)。 |
| cloud.provider | String | 对象存储服务名称:
|
| config.localStorageClass | String | 卷冗余模式(仅集群版支持):
|
| config.minReplica | Integer | 卷的最小副本数(仅集群版支持)。 |
| config.ECfragmentSize | Integer | 分片大小(仅集群版支持)。如果冗余模式为EC N+M,则会返回此项。 |
| config.sectorSize | Long | 扇区大小,单位是bytes。 |
| config.highAvailability | String | 高可用模式类型(仅集群版支持):
|
| config.writePolicy | String | 卷的写策略:
|
| config.cachePool | String | 缓存存储池(仅集群版支持)。 |
| config.pool | String | 存储池(仅集群版支持),表示最终存储池,卷数据最终落在该存储池内。 |
| config.redundancyOverlap | Integer | 卷的折叠副本数(仅集群版支持)。 |
| config.serverAffinity | Object | 卷主备分布优先级设置,详见“表5 响应参数config.serverAffinity说明”。 |
| config.qosPolicy | Object | 卷关联的QoS策略信息,详见表“6 响应参数config.qosPolicy说明”。 |
| config.qosPolicyforLUN | Object | 卷所在存储池中卷的默认QoS策略信息(仅集群版支持),详见“表7 响应参数config.qosPolicyforLUN”。 说明
|
| config.path | String | 数据目录(仅单机版支持)。 |
| dataHealth.normal | Double | 卷正常数据的百分比。 |
| dataHealth.lowRedundancy | Double | 卷降级数据的百分比。 |
| dataHealth.error | Double | 卷错误数据的百分比。 |
| dataHealth.reconstructionProgress | Double | 如果卷存在降级状态的数据,数据重建进度的百分比。 |
| dataHealth.ETR | Long | 卷如果存在降级数据,预计剩余的数据重建时间。单位为秒。如果返回值为负数,说明数据无法重建,需用户尽快修复。 |
| number | Long | 卷编号。LUN在target下的编号,由存储系统分配,对应客户端挂载存储设备时设备地址中的LUN ID。如果target下只有一个LUN,LUN的编号一般为0。 |
| uuid | String | 卷的唯一识别码。 |
| isClone | Boolean | 是否是克隆卷:
|
| sourceSnapshotName | String | 对应的快照名称(仅克隆卷支持)。 |
| snapshots.snapshotNumbers | Integer | 卷的快照个数(仅本地卷支持)。 |
| snapshots.basisofCurData | Boolean | 当前的读写是否是基于卷的初始状态:
|
| snapshots.lunSnapshots | Array of lunSnapshot | 卷的快照信息集合(仅本地卷支持),详见“表8 响应参数lunSnapshot/Children说明”。 |
| snapshots.snapshotSize | Long | 卷关联的快照大小的总和(仅本地卷支持),即快照记录的数据量。单位是bytes。 注意 卷异常或上游快照删除等因素可能导致快照大小波动。 |
| WWID | String | 卷的唯一标识符。 |
表1 响应参数iSCSITarget说明
| 名称 | 类型 | 描述 |
|---|---|---|
| iqn | String | iSCSI target IQN。 |
| status | String | 卷对应的target的状态:
|
| ips | Array of ip | iSCSI target的IP属性集合,详见“表2 响应参数ip说明”。 |
| targetPortalIP | Array of targetPortalIP | iSCSI目标门户,详见“表3 响应参数targetPortalIP说明”。 |
| serverId | String | IQN所在的服务器ID。 |
表2 响应参数ip说明
| 名称 | 类型 | 描述 |
|---|---|---|
| ip | String | iSCSI target的IP。 |
| port | Integer | iSCSI target的端口号。 |
表3 响应参数targetPortalIP说明
| 名称 | 类型 | 描述 |
|---|---|---|
| ips | Array of ip | iSCSI目标门户的IP属性集合,详见“表4 响应参数ip(iSCSI目标门户的IP)说明”。 |
| status | String | iSCSI目标门户的状态:
|
表4 响应参数ip(iSCSI目标门户的IP)说明
| 名称 | 类型 | 描述 |
|---|---|---|
| ip | String | iSCSI目标门户的IP地址。 |
| port | Integer | iSCSI目标门户的端口号。 |
表5 响应参数config.serverAffinity说明
| 名称 | 类型 | 描述 |
|---|---|---|
| autoFailback | String | 针对卷主备状态,当高优先级的服务器恢复正常后,是否自动进行主备状态切换(仅集群版支持):
|
| priority | Array of string | 卷主备分布优先级的服务器ID(仅集群版支持),系统根据指定的服务器ID顺序来选择卷的主备IQN。 |
表6 响应参数config.qosPolicy
| 名称 | 类型 | 描述 |
|---|---|---|
| qosName | String | QoS策略名称。 |
表7 响应参数config.qosPolicyforLUN
| 名称 | 类型 | 描述 |
|---|---|---|
| qosName | String | QoS策略名称。 |
| poolName | String | 存储池名称。 |
表8 响应参数lunSnapshot/Children说明
| 名称 | 类型 | 描述 |
|---|---|---|
| snapshotName | String | 快照名称。 |
| description | Integer | 快照描述信息。 |
| lunCapacity | String | 创建快照时刻,源卷的容量。 |
| consistencySnapshotName | String | 所属的一致性快照名称。 说明 仅一致性快照的卷快照显示。 |
| status | String | 快照的状态:
|
| reclaimPolicy | String | 快照回收策略:
|
| createTime | Long | 快照的创建时间。 |
| basisofCurData | Boolean | 卷当前数据是否基于该快照:
|
| snapshotSize | Long | 快照大小,具体快照记录的数据量。单位是bytes。 注意 卷异常或上游快照删除等因素可能导致快照大小波动。 |
| children | Array of children | 基于该快照创建的快照信息集合,参数解释详见本表。 |
请求示例1
单机版本地卷(非克隆卷):查询卷luna1。
GET /rest/v2/block/lun/luna1 HTTP/1.1
Date: Wed, 31 Dec 2025 08:03:56 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443响应示例1
HTTP/1.1 200 OK
x-hblock-request-id: 929380badbc446278733a8c5230c128f
Connection: keep-alive
Content-Length: 1245
Date: Wed, 31 Dec 2025 08:03:56 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"lunName": "luna1",
"targetName": "targeta",
"status": "Normal",
"capacity": 100,
"storageMode": "Local",
"createTime": 1765260238771,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:targeta.1",
"status": "Active",
"ips": [
{
"ip": "192.168.0.66",
"port": 3260
}
],
"serverId": "hblock_1"
}
],
"config": {
"sectorSize": 4096,
"writePolicy": "WriteBack",
"path": "/mnt/stor01",
"reclaimPolicy": "Retain",
"qosPolicy": {
"qosName": "QoS1"
}
},
"dataHealth": {
"normal": 100,
"lowRedundancy": 0,
"error": 0
},
"number": 0,
"uuid": "lun-uuid-b5e99a16-1ec0-415b-88d1-f14c4ac8e455",
"isClone": false,
"snapshots": {
"snapshotNumbers": 3,
"basisofCurData": false,
"lunSnapshots": [
{
"snapshotName": "luna1-s1",
"lunCapacity": 100,
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1766022586905,
"basisofCurData": false,
"children": [
{
"snapshotName": "luna1-snap20251218095041",
"lunCapacity": 100,
"consistencySnapshotName": "cons1",
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1766022641722,
"basisofCurData": false,
"children": [
{
"snapshotName": "luna1-snapshot",
"lunCapacity": 100,
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1766387371152,
"basisofCurData": true,
"snapshotSize": 45056
}
],
"snapshotSize": 200536064
}
],
"snapshotSize": 293482496
}
],
"snapshotSize": 494063616
},
"WWID": "33000000027321825"
}
}请求示例2
单机版本地卷(克隆卷):查询卷luna1-C1。
GET /rest/v2/block/lun/luna1-C1 HTTP/1.1
Date: Wed, 31 Dec 2025 08:19:51 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443响应示例2
HTTP/1.1 200 OK
x-hblock-request-id: ff7ef330b99a4632825e1b10f648d6df
Connection: keep-alive
Content-Length: 858
Date: Wed, 31 Dec 2025 08:19:51 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"lunName": "luna1-C1",
"targetName": "targeta1",
"status": "Normal",
"capacity": 200,
"storageMode": "Local",
"createTime": 1766387401903,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:targeta1.4",
"status": "Active",
"ips": [
{
"ip": "192.168.0.66",
"port": 3260
}
],
"serverId": "hblock_1"
}
],
"config": {
"sectorSize": 4096,
"writePolicy": "WriteBack",
"path": "/mnt/stor01",
"reclaimPolicy": "Retain"
},
"dataHealth": {
"normal": 100,
"lowRedundancy": 0,
"error": 0
},
"number": 0,
"uuid": "lun-uuid-e1db792b-7171-48c0-b5ae-75f2351a5356",
"isClone": true,
"sourceSnapshotName": "luna1-snapshot",
"sourceLunName": "luna1",
"snapshots": {
"snapshotNumbers": 1,
"basisofCurData": false,
"lunSnapshots": [
{
"snapshotName": "a1-C1-s1",
"lunCapacity": 200,
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1767166277470,
"basisofCurData": true,
"snapshotSize": 0
}
],
"snapshotSize": 0
},
"WWID": "33000000077524d87"
}
}请求示例3
单机版上云卷:查询卷lunb1。
GET /rest/v2/block/lun/lunb1 HTTP/1.1
Date: Wed, 31 Dec 2025 08:24:53 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443响应示例3
HTTP/1.1 200 OK
x-hblock-request-id: 284bb95a14f84f7dbdc5ae501ab09ab9
Connection: keep-alive
Content-Length: 777
Date: Wed, 31 Dec 2025 08:24:53 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"lunName": "lunb1",
"targetName": "targetb",
"status": "Normal",
"capacity": 220,
"storageMode": "Cache",
"createTime": 1765260305925,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:targetb.2",
"status": "Active",
"ips": [
{
"ip": "192.168.0.66",
"port": 3260
}
],
"serverId": "hblock_1"
}
],
"cloud": {
"bucketName": "hblocktest3",
"accessKey": "8f129a5529f202811fd0",
"endpoint": "https://oos-cn.ctyunapi.cn",
"objectSize": 1024,
"storageClass": "STANDARD",
"compression": "Enabled",
"signVersion": "v2",
"provider": "OOS"
},
"config": {
"sectorSize": 4096,
"writePolicy": "WriteBack",
"path": "/mnt/stor01",
"reclaimPolicy": "Retain",
"qosPolicy": {
"qosName": "QoS1"
}
},
"dataHealth": {
"normal": 100,
"lowRedundancy": 0,
"error": 0
},
"number": 0,
"uuid": "lun-uuid-6d66d545-e76b-489d-a9af-b918871b7626",
"WWID": "3300000003ea215ef"
}
}请求示例4
集群版本地卷(非克隆卷):查询卷lun01a。
GET /rest/v2/block/lun/lun01a HTTP/1.1
Date: Wed, 31 Dec 2025 08:26:50 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.64:1443响应示例4
HTTP/1.1 200 OK
x-hblock-request-id: 46d64571da7e4c2b9056b728cde33a49
Connection: keep-alive
Content-Length: 1414
Date: Wed, 31 Dec 2025 08:26:50 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"lunName": "lun01a",
"targetName": "target01",
"status": "Normal",
"capacity": 110,
"storageMode": "Local",
"createTime": 1766021937501,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.1",
"status": "Active",
"ips": [
{
"ip": "192.168.0.67",
"port": 3260
}
],
"serverId": "hblock_3"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.2",
"status": "Standby",
"ips": [
{
"ip": "192.168.0.64",
"port": 3260
}
],
"serverId": "hblock_2"
}
],
"config": {
"localStorageClass": "EC 2+1",
"minReplica": 2,
"sectorSize": 4096,
"highAvailability": "ActiveStandby",
"writePolicy": "WriteBack",
"pool": "default",
"redundancyOverlap": 1,
"reclaimPolicy": "Retain",
"serverAffinity": {
"autoFailback": "Enabled"
},
"qosPolicy": {
"qosName": "QoS1"
},
"qosPolicyforLUN": {
"qosName": "QoS1",
"poolName": "default"
},
"ECfragmentSize": 16
},
"dataHealth": {
"normal": 100,
"lowRedundancy": 0,
"error": 0
},
"number": 0,
"uuid": "lun-uuid-efa1d8b2-92ee-487e-8f5d-bf0c9d5f3d8d",
"isClone": false,
"snapshots": {
"snapshotNumbers": 2,
"basisofCurData": true,
"lunSnapshots": [
{
"snapshotName": "lun01a-s1",
"lunCapacity": 110,
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1766022696553,
"basisofCurData": false,
"children": [
{
"snapshotName": "lun01a-snap20251218095146",
"lunCapacity": 110,
"consistencySnapshotName": "cons1",
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1766022706147,
"basisofCurData": false,
"snapshotSize": 0
}
],
"snapshotSize": 494260224
}
],
"snapshotSize": 494260224
},
"WWID": "33fffffffc9c6296b"
}
}请求示例5
集群版本地卷(克隆卷):查询卷lun01a-C1。
GET /rest/v2/block/lun/lun01a-C1 HTTP/1.1
Date: Wed, 31 Dec 2025 08:29:57 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.64:1443响应示例5
HTTP/1.1 200 OK
x-hblock-request-id: 3673ff6f3068432f983cf3fc08d91880
Connection: keep-alive
Content-Length: 1297
Date: Wed, 31 Dec 2025 08:29:57 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"lunName": "lun01a-C1",
"targetName": "target01",
"status": "Normal",
"capacity": 110,
"storageMode": "Local",
"createTime": 1766022784343,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.1",
"status": "Active",
"ips": [
{
"ip": "192.168.0.67",
"port": 3260
}
],
"serverId": "hblock_3"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target01.2",
"status": "Standby",
"ips": [
{
"ip": "192.168.0.64",
"port": 3260
}
],
"serverId": "hblock_2"
}
],
"config": {
"localStorageClass": "EC 2+1",
"minReplica": 2,
"sectorSize": 4096,
"highAvailability": "ActiveStandby",
"writePolicy": "WriteBack",
"pool": "default",
"redundancyOverlap": 1,
"reclaimPolicy": "Retain",
"serverAffinity": {
"autoFailback": "Enabled"
},
"qosPolicy": {
"qosName": "QoS1"
},
"qosPolicyforLUN": {
"qosName": "QoS1",
"poolName": "default"
},
"ECfragmentSize": 16
},
"dataHealth": {
"normal": 100,
"lowRedundancy": 0,
"error": 0
},
"number": 2,
"uuid": "lun-uuid-28273c97-1517-4146-8aaa-8bdb5b29b51f",
"isClone": true,
"sourceSnapshotName": "lun01a-s1",
"sourceLunName": "lun01a",
"snapshots": {
"snapshotNumbers": 1,
"basisofCurData": false,
"lunSnapshots": [
{
"snapshotName": "lun01a-C1-snap20251218104054",
"lunCapacity": 110,
"consistencySnapshotName": "cons2",
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1766025654740,
"basisofCurData": true,
"snapshotSize": 4096
}
],
"snapshotSize": 4096
},
"WWID": "330000000142740b3"
}
}请求示例6
集群版上云卷:查询卷lun04c。
GET /rest/v2/block/lun/lun04c HTTP/1.1
Date: Wed, 31 Dec 2025 08:32:41 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.64:1443响应示例6
HTTP/1.1 200 OK
x-hblock-request-id: ed453e40a5e745c5961074ad300d97ae
Connection: keep-alive
Content-Length: 1145
Date: Wed, 31 Dec 2025 08:32:41 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"lunName": "lun04c",
"targetName": "target04",
"status": "Normal",
"capacity": 480,
"storageMode": "Cache",
"createTime": 1767160398843,
"iSCSITargets": [
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target04.8",
"status": "Active",
"ips": [
{
"ip": "192.168.0.67",
"port": 3260
}
],
"serverId": "hblock_3"
},
{
"iqn": "iqn.2012-08.cn.ctyunapi.oos:target04.7",
"status": "Standby",
"ips": [
{
"ip": "192.168.0.65",
"port": 3260
}
],
"serverId": "hblock_1"
}
],
"cloud": {
"bucketName": "hblocktest3",
"accessKey": "8f129a5529f202811fd0",
"endpoint": "https://oos-cn.ctyunapi.cn",
"objectSize": 1024,
"storageClass": "STANDARD",
"compression": "Enabled",
"signVersion": "v4",
"region": "cn",
"provider": "OOS"
},
"config": {
"localStorageClass": "EC 2+1",
"minReplica": 2,
"sectorSize": 4096,
"highAvailability": "ActiveStandby",
"writePolicy": "WriteBack",
"pool": "default",
"redundancyOverlap": 1,
"reclaimPolicy": "Retain",
"serverAffinity": {
"autoFailback": "Enabled"
},
"qosPolicy": {
"qosName": "QoS1"
},
"qosPolicyforLUN": {
"qosName": "QoS1",
"poolName": "default"
},
"ECfragmentSize": 16
},
"dataHealth": {
"normal": 100,
"lowRedundancy": 0,
"error": 0
},
"number": 2,
"uuid": "lun-uuid-faad3b10-cdbe-4e36-a849-2ba57987c41b",
"WWID": "33000000006405e91"
}
}