./stor lun ls [ [ { -n | --name } LUN_NAME [ {-s | --snapshot } SNAPSHOT_FORMAT | --qos ] | --clone | --wwid ]

此命令用来查询卷信息。

参数

参数	描述
-n LUN_NAME 或 --name LUN_NAME	指定要查询的卷名称。
-s SNAPSHOT_FORMAT 或 --snapshot SNAPSHOT_FORMAT	快照的展示方式： list：展示卷快照的详细信息。 tree：以树形展示快照信息。说明只有指定卷名称，才能输出卷快照信息。
--qos	查询卷关联的QoS策略。说明只有指定卷名称，才能输出QoS信息。
--clone	查询所有的克隆卷。
--wwid	指定查询卷的唯一标识符。如果客户端连接卷的时候，HBlock端有多个卷，可以通过WWID标识符来确认所要连接的卷。

示例

示例1

单机版：查询所有卷信息。

[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor lun ls
+-----+----------------------+--------------+----------+--------+------------------------------------------------------------------+------------------+---------------+----------+
| No. | LUN Name             | Storage Mode | Capacity | Status | Target                                                           | Snapshot Numbers | Snapshot Size | Is Clone |
+-----+----------------------+--------------+----------+--------+------------------------------------------------------------------+------------------+---------------+----------+
| 1.  | luna1 (LUN 0)        | Local        | 100 GiB  | Normal | iqn.2012-08.cn.ctyunapi.oos:targeta.1 (192.168.0.66:3260,Active) | 3                | 566.79 MiB    |          |
| 2.  | luna1-clone1 (LUN 1) | Local        | 100 GiB  | Normal | iqn.2012-08.cn.ctyunapi.oos:targeta.1 (192.168.0.66:3260,Active) | 0                | 0 B           | clone    |
| 3.  | luna1-clone2 (LUN 2) | Local        | 100 GiB  | Normal | iqn.2012-08.cn.ctyunapi.oos:targeta.1 (192.168.0.66:3260,Active) | 0                | 0 B           | clone    |
| 4.  | lunb1 (LUN 0)        | Local        | 200 GiB  | Normal | iqn.2012-08.cn.ctyunapi.oos:targetb.2 (192.168.0.66:3260,Active) | 1                | 283.01 MiB    |          |
| 5.  | lunc1 (LUN 0)        | Local        | 300 GiB  | Normal | iqn.2012-08.cn.ctyunapi.oos:targetc.3 (192.168.0.66:3260,Active) | 0                | 0 B           |          |
| 6.  | lund1 (LUN 0)        | Cache        | 404 GiB  | Normal | iqn.2012-08.cn.ctyunapi.oos:targetd.4 (192.168.0.66:3260,Active) | 0                | 0 B           |          |
| 7.  | lund2 (LUN 1)        | Storage      | 440 GiB  | Normal | iqn.2012-08.cn.ctyunapi.oos:targetd.4 (192.168.0.66:3260,Active) | 0                | 0 B           |          |
+-----+----------------------+--------------+----------+--------+------------------------------------------------------------------+------------------+---------------+----------+

单机版：查询所有的克隆卷。

[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor lun ls --clone
+-----+----------------------+--------------+----------+--------+------------------------------------------------------------------+------------------+---------------+----------+
| No. | LUN Name             | Storage Mode | Capacity | Status | Target                                                           | Snapshot Numbers | Snapshot Size | Is Clone |
+-----+----------------------+--------------+----------+--------+------------------------------------------------------------------+------------------+---------------+----------+
| 1.  | luna1-clone1 (LUN 1) | Local        | 100 GiB  | Normal | iqn.2012-08.cn.ctyunapi.oos:targeta.1 (192.168.0.66:3260,Active) | 0                | 0 B           | clone    |
| 2.  | luna1-clone2 (LUN 2) | Local        | 100 GiB  | Normal | iqn.2012-08.cn.ctyunapi.oos:targeta.1 (192.168.0.66:3260,Active) | 0                | 0 B           | clone    |
+-----+----------------------+--------------+----------+--------+------------------------------------------------------------------+------------------+---------------+----------+

单机版：查询所有卷的标识符。

[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor lun ls --wwid
+-----+----------------------+--------------+----------+--------+------------------------------------------------------------------+------------------+---------------+----------+-------------------+
| No. | LUN Name             | Storage Mode | Capacity | Status | Target                                                           | Snapshot Numbers | Snapshot Size | Is Clone | WWID              |
+-----+----------------------+--------------+----------+--------+------------------------------------------------------------------+------------------+---------------+----------+-------------------+
| 1.  | luna1 (LUN 0)        | Local        | 100 GiB  | Normal | iqn.2012-08.cn.ctyunapi.oos:targeta.1 (192.168.0.66:3260,Active) | 3                | 566.79 MiB    |          | 33fffffffc009e3e5 |
| 2.  | luna1-clone1 (LUN 1) | Local        | 100 GiB  | Normal | iqn.2012-08.cn.ctyunapi.oos:targeta.1 (192.168.0.66:3260,Active) | 0                | 0 B           | clone    | 33fffffffd16f4794 |
| 3.  | luna1-clone2 (LUN 2) | Local        | 100 GiB  | Normal | iqn.2012-08.cn.ctyunapi.oos:targeta.1 (192.168.0.66:3260,Active) | 0                | 0 B           | clone    | 33fffffffeb20822d |
| 4.  | lunb1 (LUN 0)        | Local        | 200 GiB  | Normal | iqn.2012-08.cn.ctyunapi.oos:targetb.2 (192.168.0.66:3260,Active) | 1                | 283.01 MiB    |          | 33ffffffff10e7b96 |
| 5.  | lunc1 (LUN 0)        | Local        | 300 GiB  | Normal | iqn.2012-08.cn.ctyunapi.oos:targetc.3 (192.168.0.66:3260,Active) | 0                | 0 B           |          | 33fffffffa04e8d4c |
| 6.  | lund1 (LUN 0)        | Cache        | 404 GiB  | Normal | iqn.2012-08.cn.ctyunapi.oos:targetd.4 (192.168.0.66:3260,Active) | 0                | 0 B           |          | 33ffffffffa00671b |
| 7.  | lund2 (LUN 1)        | Storage      | 440 GiB  | Normal | iqn.2012-08.cn.ctyunapi.oos:targetd.4 (192.168.0.66:3260,Active) | 0                | 0 B           |          | 33fffffffe2f122be |
+-----+----------------------+--------------+----------+--------+------------------------------------------------------------------+------------------+---------------+----------+-------------------+

集群版：查询所有卷信息。

[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor lun ls
+-----+------------------------+--------------+----------+---------------------+------------------------+--------+--------------------------------------------------------------------+------------------+---------------+----------+
| No. | LUN Name               | Storage Mode | Capacity | Local Storage Class | Minimum Replica Number | Status | Target                                                             | Snapshot Numbers | Snapshot Size | Is Clone |
+-----+------------------------+--------------+----------+---------------------+------------------------+--------+--------------------------------------------------------------------+------------------+---------------+----------+
| 1.  | lun01a (LUN 0)         | Local        | 200 GiB  | EC 2+1+16KiB        | 2                      | Normal | iqn.2012-08.cn.ctyunapi.oos:target01.1 (192.168.0.67:3260,Active)  | 3                | 758.11 MiB    |          |
|     |                        |              |          |                     |                        |        | iqn.2012-08.cn.ctyunapi.oos:target01.2 (192.168.0.65:3260,Standby) |                  |               |          |
| 2.  | lun02a (LUN 0)         | Cache        | 220 GiB  | EC 2+1+16KiB        | 2                      | Normal | iqn.2012-08.cn.ctyunapi.oos:target02.3 (192.168.0.64:3260,Active)  | 0                | 0 B           |          |
|     |                        |              |          |                     |                        |        | iqn.2012-08.cn.ctyunapi.oos:target02.4 (192.168.0.67:3260,Standby) |                  |               |          |
| 3.  | lun03a (LUN 0)         | Storage      | 1 GiB    | EC 2+1+16KiB        | 2                      | Normal | iqn.2012-08.cn.ctyunapi.oos:target03.5 (192.168.0.64:3260,Active)  | 0                | 0 B           |          |
|     |                        |              |          |                     |                        |        | iqn.2012-08.cn.ctyunapi.oos:target03.6 (192.168.0.65:3260,Standby) |                  |               |          |
| 4.  | lunn01a-clone1 (LUN 3) | Local        | 200 GiB  | EC 2+1+16KiB        | 2                      | Normal | iqn.2012-08.cn.ctyunapi.oos:target01.2 (192.168.0.65:3260,Active)  | 1                | 4 KiB         | clone    |
|     |                        |              |          |                     |                        |        | iqn.2012-08.cn.ctyunapi.oos:target01.1 (192.168.0.67:3260,Standby) |                  |               |          |
| 5.  | q (LUN 1)              | Storage      | 1 GiB    | EC 2+1+16KiB        | 2                      | Normal | iqn.2012-08.cn.ctyunapi.oos:target01.2 (192.168.0.65:3260,Active)  | 0                | 0 B           |          |
|     |                        |              |          |                     |                        |        | iqn.2012-08.cn.ctyunapi.oos:target01.1 (192.168.0.67:3260,Standby) |                  |               |          |
| 6.  | w (LUN 2)              | Cache        | 1 GiB    | EC 2+1+16KiB        | 2                      | Normal | iqn.2012-08.cn.ctyunapi.oos:target01.1 (192.168.0.67:3260,Active)  | 0                | 0 B           |          |
|     |                        |              |          |                     |                        |        | iqn.2012-08.cn.ctyunapi.oos:target01.2 (192.168.0.65:3260,Standby) |                  |               |          |
+-----+------------------------+--------------+----------+---------------------+------------------------+--------+--------------------------------------------------------------------+------------------+---------------+----------+

集群版：查询所有克隆卷。

[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor lun ls --clone
+-----+------------------------+--------------+----------+---------------------+------------------------+--------+--------------------------------------------------------------------+------------------+---------------+----------+
| No. | LUN Name               | Storage Mode | Capacity | Local Storage Class | Minimum Replica Number | Status | Target                                                             | Snapshot Numbers | Snapshot Size | Is Clone |
+-----+------------------------+--------------+----------+---------------------+------------------------+--------+--------------------------------------------------------------------+------------------+---------------+----------+
| 1.  | lun01a-clone2 (LUN 4)  | Local        | 200 GiB  | EC 2+1+16KiB        | 2                      | Normal | iqn.2012-08.cn.ctyunapi.oos:target01.1 (192.168.0.67:3260,Active)  | 0                | 0 B           | clone    |
|     |                        |              |          |                     |                        |        | iqn.2012-08.cn.ctyunapi.oos:target01.2 (192.168.0.65:3260,Standby) |                  |               |          |
| 2.  | lunn01a-clone1 (LUN 3) | Local        | 200 GiB  | EC 2+1+16KiB        | 2                      | Normal | iqn.2012-08.cn.ctyunapi.oos:target01.2 (192.168.0.65:3260,Active)  | 1                | 4 KiB         | clone    |
|     |                        |              |          |                     |                        |        | iqn.2012-08.cn.ctyunapi.oos:target01.1 (192.168.0.67:3260,Standby) |                  |               |          |
+-----+------------------------+--------------+----------+---------------------+------------------------+--------+--------------------------------------------------------------------+------------------+---------------+----------+

集群版：查询所有卷的标识符信息。

[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor lun ls --wwid
+-----+------------------------+--------------+----------+---------------------+------------------------+--------+--------------------------------------------------------------------+------------------+---------------+----------+-------------------+
| No. | LUN Name               | Storage Mode | Capacity | Local Storage Class | Minimum Replica Number | Status | Target                                                             | Snapshot Numbers | Snapshot Size | Is Clone | WWID              |
+-----+------------------------+--------------+----------+---------------------+------------------------+--------+--------------------------------------------------------------------+------------------+---------------+----------+-------------------+
| 1.  | lun01a (LUN 0)         | Local        | 200 GiB  | EC 2+1+16KiB        | 2                      | Normal | iqn.2012-08.cn.ctyunapi.oos:target01.1 (192.168.0.67:3260,Active)  | 3                | 758.11 MiB    |          | 3300000000778b304 |
|     |                        |              |          |                     |                        |        | iqn.2012-08.cn.ctyunapi.oos:target01.2 (192.168.0.65:3260,Standby) |                  |               |          |                   |
| 2.  | lun01a-clone2 (LUN 4)  | Local        | 200 GiB  | EC 2+1+16KiB        | 2                      | Normal | iqn.2012-08.cn.ctyunapi.oos:target01.1 (192.168.0.67:3260,Active)  | 0                | 0 B           | clone    | 3300000002e12e175 |
|     |                        |              |          |                     |                        |        | iqn.2012-08.cn.ctyunapi.oos:target01.2 (192.168.0.65:3260,Standby) |                  |               |          |                   |
| 3.  | lun02a (LUN 0)         | Cache        | 220 GiB  | EC 2+1+16KiB        | 2                      | Normal | iqn.2012-08.cn.ctyunapi.oos:target02.3 (192.168.0.64:3260,Active)  | 0                | 0 B           |          | 3300000000a4dbab4 |
|     |                        |              |          |                     |                        |        | iqn.2012-08.cn.ctyunapi.oos:target02.4 (192.168.0.67:3260,Standby) |                  |               |          |                   |
| 4.  | lun03a (LUN 0)         | Storage      | 1 GiB    | EC 2+1+16KiB        | 2                      | Normal | iqn.2012-08.cn.ctyunapi.oos:target03.5 (192.168.0.64:3260,Active)  | 0                | 0 B           |          | 33fffffff9bc63bb8 |
|     |                        |              |          |                     |                        |        | iqn.2012-08.cn.ctyunapi.oos:target03.6 (192.168.0.65:3260,Standby) |                  |               |          |                   |
| 5.  | lunn01a-clone1 (LUN 3) | Local        | 200 GiB  | EC 2+1+16KiB        | 2                      | Normal | iqn.2012-08.cn.ctyunapi.oos:target01.2 (192.168.0.65:3260,Active)  | 1                | 4 KiB         | clone    | 33fffffff85d2e19e |
|     |                        |              |          |                     |                        |        | iqn.2012-08.cn.ctyunapi.oos:target01.1 (192.168.0.67:3260,Standby) |                  |               |          |                   |
| 6.  | q (LUN 1)              | Storage      | 1 GiB    | EC 2+1+16KiB        | 2                      | Normal | iqn.2012-08.cn.ctyunapi.oos:target01.2 (192.168.0.65:3260,Active)  | 0                | 0 B           |          | 330000000161ee9df |
|     |                        |              |          |                     |                        |        | iqn.2012-08.cn.ctyunapi.oos:target01.1 (192.168.0.67:3260,Standby) |                  |               |          |                   |
| 7.  | w (LUN 2)              | Cache        | 1 GiB    | EC 2+1+16KiB        | 2                      | Normal | iqn.2012-08.cn.ctyunapi.oos:target01.1 (192.168.0.67:3260,Active)  | 0                | 0 B           |          | 330000000495cca02 |
|     |                        |              |          |                     |                        |        | iqn.2012-08.cn.ctyunapi.oos:target01.2 (192.168.0.65:3260,Standby) |                  |               |          |                   |
+-----+------------------------+--------------+----------+---------------------+------------------------+--------+--------------------------------------------------------------------+------------------+---------------+----------+-------------------+

项目	描述
No.	序号。
LUN Name	包括卷名称和卷编号。括号内容表示卷编号。卷编号：LUN在Target下的编号，由存储系统分配，对应客户端挂载存储设备时设备地址中的LUN ID。如果Target下只有一个LUN，LUN的编号一般为0。
Storage Mode	卷的存储类型： Local：本地模式，数据全部保留在本地。 Cache：缓存模式，本地保留部分热数据，全部数据异步存储到对象存储中。 Storage：存储模式，本地保留全部数据，并异步存储到对象存储中。
Capacity	卷容量。
Local Storage Class	卷冗余模式（仅集群版支持）： single-copy：单副本。 2-copy：两副本。 3-copy：三副本。 EC N+M+分片大小。
Minimum Replica Number	最小副本数（仅集群版支持）。
Status	卷的状态： Normal：正常。 Deleting：卷正在删除中。 DeleteFailed：卷删除失败。 Recovering：卷正在还原中。 RecoverFailed：卷还原失败。 Rollbacking：卷正在回滚。 Flattening：与快照的关系链断开过程中，表示克隆卷正在复制源卷的数据，复制完成之后将变成独立卷，不再依赖快照和源卷。 Importing：正在导入备份数据。 Wiping：卷正在清空数据。 WipeFailed：清空数据失败。
Target	卷关联的target，包括target IQN、target IP、target端口号、卷对应的target的状态（Active：主target；Standby：热备target；Offline：离线target；ColdStandby：冷备target）。
Snapshot Numbers	卷的快照个数（仅本地卷支持）。
Snapshot Size	卷关联的快照大小的总和（仅本地卷支持），即快照记录的数据量。注意卷异常或上游快照删除等因素可能导致快照大小波动。
Is Clone	该卷是否为克隆卷： clone：表示卷为克隆卷。不显示表示该卷不是克隆卷。
WWID	卷的唯一标识符。如果客户端连接卷的时候，HBlock端有多个卷，可以通过WWID标识符来确认所要连接的卷。

示例2

单机版本地卷：查询卷luna1(非克隆卷)的信息。

[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor lun ls -n luna1
LUN Name: luna1 (LUN 0)
Storage Mode: Local
Capacity: 100 GiB
Status: Normal
iSCSI Target: iqn.2012-08.cn.ctyunapi.oos:targeta.1 (192.168.0.66:3260,Active)
Create Time: 2025-07-30 14:19:13
Local Sector Size: 4096 bytes
Write Policy: WriteBack
WWID: 33fffffffc009e3e5
UUID: lun-uuid-c17cf2cf-093e-432c-8d13-5eec61f97fbb
Path: /mnt/stor01
Snapshot Numbers: 3
Snapshot Size: 566.79 MiB (Note: Snapshot size may vary due to LUN issues or parent snapshot deletion.)

单机版本地卷：查询卷luna1-clone1(克隆卷)的信息。

[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]#./stor lun ls -n luna1-clone1
LUN Name: luna1-clone1 (LUN 1)
Storage Mode: Local
Capacity: 100 GiB
Status: Normal
iSCSI Target: iqn.2012-08.cn.ctyunapi.oos:targeta.1 (192.168.0.66:3260,Active)
Create Time: 2025-08-01 17:24:28
Local Sector Size: 4096 bytes
Write Policy: WriteBack
WWID: 33fffffffd16f4794
UUID: lun-uuid-d79b251d-16ff-451a-833f-ed3fc935c2ef
Path: /mnt/stor01
Source Snapshot: luna1-snap1
Source LUN: luna1
Snapshot Numbers: 0
Snapshot Size: 0 B (Note: Snapshot size may vary due to LUN issues or parent snapshot deletion.)

单机版上云卷：查询卷lunb1的信息。

[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor lun ls -n lunb1
LUN Name: lunb1 (LUN 0)
Storage Mode: Cache
Capacity: 200 GiB
Status: Normal
iSCSI Target: iqn.2012-08.cn.ctyunapi.oos:targetb.2 (192.168.0.66:3260,Active)
Create Time: 2025-02-27 18:04:14
Local Sector Size: 4096 bytes
Write Policy: WriteBack
WWID: 33fffffff9449437a
UUID: lun-uuid-fc9a2f2c-c8bd-462b-8684-49e6e1650b1c
Path: /mnt/stor01
Object Storage Info:
+-------------------+----------------------------+
| Provider          | OOS                        |
| Bucket Name       | hblocktest3                |
| Prefix            | lunb                       |
| Endpoint          | https://oos-cn.ctyunapi.cn |
| Signature Version | v4                         |
| Region            | cn                         |
| Storage Class     | STANDARD                   |
| Access Key        | 8f129a5529f202811fd0       |
| Object Size       | 1024 KiB                   |
| Compression       | Enabled                    |
+-------------------+----------------------------+

集群版本地卷：查询卷lun01a（非克隆卷）的信息。

[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor lun ls -n lun01a
LUN Name: lun01a (LUN 0)
Storage Mode: Local
Capacity: 200 GiB
Status: Normal
Auto Failback: Enabled
iSCSI Target: iqn.2012-08.cn.ctyunapi.oos:target01.1 (192.168.0.67:3260,Active)
              iqn.2012-08.cn.ctyunapi.oos:target01.2 (192.168.0.65:3260,Standby)
Create Time: 2025-07-29 17:58:03
Local Storage Class: EC 2+1+16KiB
Minimum Replica Number: 2
Redundancy Overlap: 1
Local Sector Size: 4096 bytes
Storage Pool: default
High Availability: ActiveStandby
Write Policy: WriteBack
WWID: 3300000000778b304
UUID: lun-uuid-816fdcce-7499-4fca-8a49-5d3bffc09603
Snapshot Numbers: 3
Snapshot Size: 758.11 MiB (Note: Snapshot size may vary due to LUN issues or parent snapshot deletion.)

集群版本地卷查询卷lun01a-clone2（克隆卷）的信息。

[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor lun ls -n lun01a-clone2
LUN Name: lun01a-clone2 (LUN 4)
Storage Mode: Local
Capacity: 200 GiB
Status: Normal
Auto Failback: Enabled
iSCSI Target: iqn.2012-08.cn.ctyunapi.oos:target01.1 (192.168.0.67:3260,Active)
              iqn.2012-08.cn.ctyunapi.oos:target01.2 (192.168.0.65:3260,Standby)
Create Time: 2025-08-01 17:18:15
Local Storage Class: EC 2+1+16KiB
Minimum Replica Number: 2
Redundancy Overlap: 1
Local Sector Size: 4096 bytes
Storage Pool: default
High Availability: ActiveStandby
Write Policy: WriteBack
WWID: 3300000002e12e175
UUID: lun-uuid-2ae58d63-b8ba-4dc4-acf5-68a7c6f51a42
Source Snapshot: lun01a-snap20250801171358
Source LUN: lun01a
Snapshot Numbers: 0
Snapshot Size: 0 B (Note: Snapshot size may vary due to LUN issues or parent snapshot deletion.)

集群版上云卷：查询卷lun02a的信息。

[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor lun ls -n lun02a
LUN Name: lun02a (LUN 0)
Storage Mode: Cache
Capacity: 220 GiB
Status: Normal
Auto Failback: Enabled
iSCSI Target: iqn.2012-08.cn.ctyunapi.oos:target02.3 (192.168.0.64:3260,Active)
              iqn.2012-08.cn.ctyunapi.oos:target02.4 (192.168.0.67:3260,Standby)
Create Time: 2025-08-01 15:33:15
Local Storage Class: EC 2+1+16KiB
Minimum Replica Number: 2
Redundancy Overlap: 1
Local Sector Size: 4096 bytes
Storage Pool: default
High Availability: ActiveStandby
Write Policy: WriteBack
WWID: 3300000000a4dbab4
UUID: lun-uuid-99d497cc-1322-4011-acb4-78d5f3bdb810
Object Storage Info:
+-------------------+----------------------------+
| Provider          | OOS                        |
| Bucket Name       | hblocktest3                |
| Endpoint          | https://oos-cn.ctyunapi.cn |
| Signature Version | v4                         |
| Region            | cn                         |
| Storage Class     | STANDARD                   |
| Access Key        | 8f129a5529f202811fd0       |
| Object Size       | 1024 KiB                   |
| Compression       | Enabled                    |
+-------------------+----------------------------+

集群版上云卷：查询卷lun04a（还原失败）的信息。

[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor lun ls -n lun04a
LUN Name: lun04a (LUN 0)
Storage Mode: Storage
Capacity: 440 GiB
Status: RecoverFailed
Failed Reason: Unknown Error, please resume LUN recovery later or contact your software vendor.
Auto Failback: Enabled
iSCSI Target: iqn.2012-08.cn.ctyunapi.oos:target04.7(192.168.0.102:3260,Offline)
              iqn.2012-08.cn.ctyunapi.oos:target04.8(192.168.0.117:3260,Offline)
Create Time: 2024-12-17 17:25:37
Local Storage Class: EC 2+1+16KiB
Minimum Replica Number: 2
Redundancy Overlap: 1
Local Sector Size: 4096 bytes
Cache Storage Pool: pool3
Storage Pool: default
High Availability: ActiveStandby
Write Policy: WriteThrough
WWID: 3300000006d8b38ff
UUID: lun-uuid-2883e7a4-8a34-4ba2-9d4c-00374f43c1e6
Object Storage Info:
+-------------------+----------------------------+
| Provider          | OOS                        |
| Bucket Name       | hblocktest3                |
| Endpoint          | https://oos-cn.ctyunapi.cn |
| Signature Version | v2                         |
| Region            |                            |
| Storage Class     | STANDARD                   |
| Access Key        | 8f129a5529f202811fd0       |
| Object Size       | 1024 KiB                   |
| Compression       | Enabled                    |
+-------------------+----------------------------+

项目	描述
LUN Name	包括卷名称和卷编号。括号内容表示卷编号。卷编号：LUN在Target下的编号，由存储系统分配，对应客户端挂载存储设备时设备地址中的LUN ID。如果Target下只有一个LUN，LUN的编号一般为0。
Storage Mode	卷的存储类型： Local：本地模式，数据全部保留在本地。 Cache：缓存模式，本地保留部分热数据，全部数据异步存储到对象存储中。 Storage：存储模式，本地保留全部数据，并异步存储到对象存储中。
Capacity	卷容量。
Status	卷的状态： Normal：正常。 Deleting：卷正在删除中。 DeleteFailed：卷删除失败。 Recovering：卷正在还原中。 RecoverFailed：卷还原失败。 Rollbacking：卷正在回滚。 Flattening：与快照的关系链断开过程中，表示克隆卷正在复制源卷的数据，复制完成之后将变成独立卷，不再依赖快照和源卷。 Importing：正在导入备份数据。 Wiping：卷正在清空数据。 WipeFailed：清空数据失败。
Failed Reason	失败原因：卷还原失败的原因（卷状态为RecoverFailed时显示），卷删除失败的原因（卷状态为DeleteFailed时显示），或者卷清空失败的原因（卷状态为WipeFailed显示）。
Auto Failback	针对卷主备状态，当高优先级的服务器恢复正常后，是否自动进行主备状态切换： Enabled：自动进行主备切换。 Disabled：不自动进行主备切换。
iSCSI Target	卷关联的Target，包括target IQN、target IP、target端口号、卷对应的Target的状态（Active：主target；Standby：热备target；offline：离线target；ColdStandby：冷备target）。
Create Time	卷创建的时间。
Local Storage Class	卷冗余模式（仅集群版支持）： single-copy：单副本。 2-copy：两副本。 3-copy：三副本。 EC N+M+分片大小。
Minimum Replica Number	最小副本数（仅集群版支持）。
Redundancy Overlap	卷的折叠副本数（仅集群版支持）。
Local Sector Size	扇区大小。
Cache Storage Pool	缓存存储池（仅集群版支持）。
Storage Pool	存储池（仅集群版支持），表示最终存储池，卷数据最终落在该存储池内。
High Availability	卷的高可用类型（仅集群版支持）： ActiveStandby：启用主备，该卷关联对应target下的所有IQN。 Disabled：不启用主备，该卷关联对应target下的1个IQN。
Write Policy	卷的写策: WriteBack：回写，指数据写入到内存后即返回客户端成功，之后再异步写入磁盘。 WriteThrough：透写，指数据同时写入内存和磁盘，并在都写成功后再返回客户端成功。 WriteAround：绕写，指数据直接写到磁盘，不写入内存。
WWID	卷的唯一标识符。如果客户端连接卷的时候，HBlock端有多个卷，可以通过WWID标识符来确认所要连接的卷。
UUID	卷的唯一识别码。
Path	存储卷数据的数据目录（仅单机版支持）。
Source Snapshot	克隆卷关联的快照（仅克隆卷支持）。
Source LUN	克隆卷的源卷名称（仅克隆卷支持）。
Snapshot Numbers	卷的快照个数（仅本地卷支持）。
Snapshot Size	卷关联的快照大小的总和（仅本地卷支持），即快照记录的数据量。注意卷异常或上游快照删除等因素可能导致快照大小波动。
Object Storage Info	卷上云信息，包括：Provider、Bucket Name、Prefix、Endpoint、Signature Version、Region、Storage Class、Access Key、Object Size、Compression。
Provider	对象存储服务名称： OOS：天翼云对象存储经典版I型。 S3：兼容S3的其他对象存储。
Bucket Name	存储桶名称。
Prefix	卷数据存储在对象存储的前缀名称。如果未设置，则不显示此项。
Endpoint	对象存储服务的Endpoint。
Signature Version	上云签名认证的类型： v2：V2签名认证。 v4：V4签名认证。
Region	对象存储服务的Endpoint资源池所在区域。如果是V2签名，此处为空。
Storage Class	对象存储服务的的存储类型： STANDARD：标准存储。 STANDARD_IA：低频访问存储。
Access Key	对象存储服务的AccessKeyID。
Object Size	数据存储在对象存储中的大小。
Compression	是否压缩数据上传至对象存储： Enabled：压缩数据上传至对象存储。 Disabled：不压缩数据上传至对象存储。

示例3

本地卷：查询卷lun01a的快照信息，快照以树形展示

[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor lun ls -n lun01a -s tree
LUN Name: lun01a (LUN 0)
Storage Mode: Local
Capacity: 200 GiB
Status: Normal
Auto Failback: Enabled
iSCSI Target: iqn.2012-08.cn.ctyunapi.oos:target01.2 (192.168.0.65:3260,Active)
              iqn.2012-08.cn.ctyunapi.oos:target01.1 (192.168.0.67:3260,Standby)
Create Time: 2025-07-29 17:58:03
Local Storage Class: EC 2+1+16KiB
Minimum Replica Number: 2
Redundancy Overlap: 1
Local Sector Size: 4096 bytes
Storage Pool: default
High Availability: ActiveStandby
Write Policy: WriteBack
WWID: 3300000000778b304
UUID: lun-uuid-816fdcce-7499-4fca-8a49-5d3bffc09603
Snapshot Numbers: 3
Snapshot Size: 758.11 MiB (Note: Snapshot size may vary due to LUN issues or parent snapshot deletion.)
Snapshots:
snap1
└── lun01a-snap2
    └── lun01a-snap20250801171358 (*)

本地卷：查询卷lun01a的快照信息，展示快照的详细信息。

[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor lun ls -n lun01a -s list
LUN Name: lun01a (LUN 0)
Storage Mode: Local
Capacity: 200 GiB
Status: Normal
Auto Failback: Enabled
iSCSI Target: iqn.2012-08.cn.ctyunapi.oos:target01.2 (192.168.0.65:3260,Active)
              iqn.2012-08.cn.ctyunapi.oos:target01.1 (192.168.0.67:3260,Standby)
Create Time: 2025-07-29 17:58:03
Local Storage Class: EC 2+1+16KiB
Minimum Replica Number: 2
Redundancy Overlap: 1
Local Sector Size: 4096 bytes
Storage Pool: default
High Availability: ActiveStandby
Write Policy: WriteBack
WWID: 3300000000778b304
UUID: lun-uuid-816fdcce-7499-4fca-8a49-5d3bffc09603
Snapshot Numbers: 3
Snapshot Size: 758.11 MiB (Note: Snapshot size may vary due to LUN issues or parent snapshot deletion.)
Snapshots:
+-----+-------------------------------+------------+---------------------------+--------------+----------------+--------+---------------------+
| No. | Name                          | Size       | Consistency Snapshot Name | LUN Capacity | Reclaim Policy | Status | Create Time         |
+-----+-------------------------------+------------+---------------------------+--------------+----------------+--------+---------------------+
| 1.  | snap1                         | 88.74 MiB  | -                         | 200 GiB      | Retain         | Normal | 2025-07-30 14:53:30 |
| 2.  | lun01a-snap2                  | 478.08 MiB | -                         | 200 GiB      | Delete         | Normal | 2025-08-01 17:12:30 |
| 3.  | lun01a-snap20250801171358 (*) | 191.3 MiB  | conssnap1                 | 200 GiB      | Retain         | Normal | 2025-08-01 17:13:59 |
+-----+-------------------------------+------------+---------------------------+--------------+----------------+--------+---------------------+

查询指定卷的快照信息

项目	描述
LUN Name	包括卷名称和卷编号。括号内容表示卷编号。卷编号：LUN在target下的编号，由存储系统分配，对应客户端挂载存储设备时设备地址中的LUN ID。如果target下只有一个LUN，LUN的编号一般为0。
Storage Mode	卷的存储类型： Local：本地模式，数据全部保留在本地。仅本地卷支持快照。
Capacity	卷容量。
Status	卷的状态： Normal：正常。 Deleting：卷正在删除中。 DeleteFailed：卷删除失败。 Recovering：卷正在还原中。 RecoverFailed：卷还原失败。 Rollbacking：卷正在回滚。 Flattening：与快照的关系链断开过程中，表示克隆卷正在复制源卷的数据，复制完成之后将变成独立卷，不再依赖快照和源卷。 Importing：正在导入备份数据。 Wiping：卷正在清空数据。 WipeFailed：清空数据失败。
Auto Failback	针对卷主备状态，当高优先级的服务器恢复正常后，是否自动进行主备状态切换： Enabled：自动进行主备切换。 Disabled：不自动进行主备切换。
iSCSI Target	卷关联的target，包括target IQN、target IP、target端口号、卷对应的target的状态（Active：主target；Standby：热备target；offline：离线target；ColdStandby：冷备target）。
Create Time	卷创建的时间。
Local Storage Class	卷冗余模式（仅集群版支持）： single-copy：单副本。 2-copy：两副本。 3-copy：三副本。 EC N+M+分片大小。
Minimum Replica Number	最小副本数（仅集群版支持）。
Redundancy Overlap	卷的折叠副本数（仅集群版支持）。
Local Sector Size	扇区大小。
Cache Storage Pool	缓存存储池（仅集群版支持）。
Storage Pool	存储池（仅集群版支持），表示最终存储池，卷数据最终落在该存储池内。
High Availability	卷的高可用类型（仅集群版支持）： ActiveStandby：启用主备，该卷关联对应Target下的所有IQN。 Disabled：不启用主备，该卷关联对应Target下的1个IQN。
Write Policy	卷的写策: WriteBack：回写，指数据写入到内存后即返回客户端成功，之后再异步写入磁盘。 WriteThrough：透写，指数据同时写入内存和磁盘，并在都写成功后再返回客户端成功。 WriteAround：绕写，指数据直接写到磁盘，不写入内存。
WWID	卷的唯一标识符。如果客户端连接卷的时候，HBlock端有多个卷，可以通过WWID标识符来确认所要连接的卷。
UUID	卷的唯一识别码。
Path	存储卷数据的数据目录（仅单机版支持）。
Source Snapshot	克隆卷关联的快照（仅克隆卷支持）。
Source LUN	克隆卷的源卷名称（仅克隆卷支持）。
Snapshot Numbers	卷的快照个数（仅本地卷支持）。
Snapshot Size	卷关联的快照大小的总和（仅本地卷支持），即快照记录的数据量。注意卷异常或上游快照删除等因素可能导致快照大小波动。
Snapshots	卷快照信息。
	快照以详细信息展示，包括下列信息： No.：序号。 Name：快照名称。*：表示当前的读写是以此快照为基础。 Consistency Snapshot Name：所属的一致性快照名称。仅一致性快照的卷快照显示，“-”表示不是一致性快照的卷快照。 LUN Capacity：创建快照时刻，源卷的容量。 Reclaim Policy：快照回收策略： Delete：当快照无关联克隆卷，且最多拥有1个子节点（子节点表示存在其他快照依赖此快照，或者当前写操作基于此快照），快照自动删除。 Retain：当快照无关联克隆卷，且最多拥有1个子节点，快照仍然保留。 Status：快照的状态： Normal：正常。 Error：异常。 Pending：创建中。 Deleting：删除中。 Create Time：快照的创建时间。
	快照以树形展示，仅包含快照名称，“*”表示当前的读写是以此快照为基础。

示例4

单机版：查询卷luna1关联的QoS策略。

[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor lun ls -n luna1 --qos
The specific QoS policy for LUN luna1
  QoS Policy Name: QoS1
  Reclaim Policy: Retain
  IOPS (Total/Read/Write): 2500/1000/1000
  Bandwidth (Total/Read/Write): 4.88 GiB/s | 3.42 GiB/s | 3.42 GiB/s
  Burst IOPS (Total/Read/Write): 2000/1000/1500
  Burst Bandwidth (Total/Read/Write): 4.88 GiB/s | 3.42 GiB/s | 3.42 GiB/s
  Burst Duration (second): 1/1/1/1/1/1
  Create Time: 2025-08-05 14:29:22
  Description: It is QoS1.

集群版：查询卷lun01a关联的QoS策略。

[root@hblockserver CTYUN_HBlock_Plus_3.10.0_x64]# ./stor lun ls -n lun01a --qos
The specific QoS policy for LUN lun01a
  QoS Policy Name: QoS6
  Reclaim Policy: Retain
  IOPS (Total/Read/Write): 1000/600/400
  Bandwidth (Total/Read/Write): Unlimited
  Burst IOPS (Total/Read/Write): 10000/6000/4000
  Burst Bandwidth (Total/Read/Write): Unlimited
  Burst Duration (second): 1/1/1/1/1/1
  Create Time: 2025-07-31 16:28:51
  Description: It is QoS6.

The default QoS policy in pool for LUN lun01a
  Storage Pool Name: defaultpool
  QoS Policy Name: Qos-Test
  Reclaim Policy: Retain
  IOPS (Total/Read/Write): 8000/Unlimited/Unlimited
  Bandwidth (Total/Read/Write): 7.81 GiB/s | Unlimited | Unlimited
  Burst IOPS (Total/Read/Write): Unlimited
  Burst Bandwidth (Total/Read/Write): Unlimited
  Burst Duration (second): 1/1/1/1/1/1
  Create Time: 2025-08-06 17:02:32

查询卷关联的QoS策略信息的描述

项目	描述
The specific QoS policy for LUN lunName	卷的QoS策略。
The default QoS policy in pool for LUN lunName	存储池内卷的默认QoS策略（仅集群版支持）。如果卷的缓存存储池和存储池同时存在时，展示缓存存储池的“存储池内卷的默认QoS策略”；如果缓存存储池未设置“存储池内卷的默认QoS策略”，则不显示此项。如果卷只有存储池：展示存储池的“存储池内卷的默认QoS策略”；如果存储池未设置“存储池内卷的默认QoS策略”，则不显示此项。
QoS Policy Name	QoS策略名称。
Reclaim Policy	QoS策略的回收策略： Delete：解除QoS策略关联的所有对象或者删除QoS策略关联的所有对象，系统会触发删除QoS策略。 Retain：解除QoS策略关联的所有对象或者删除QoS策略关联的所有对象，QoS策略仍保留。
IOPS (Total/Read/Write)	每秒能够进行读写操作/读操作/写操作次数的最大值。
Bandwidth (Total/Read/Write)	总带宽/读带宽/写带宽上限。
Burst IOPS (Total/Read/Write)	使用Burst功能时，每秒能够进行读写操作/读操作/写操作次数的最大值。
Burst Bandwidth (Total/Read/Write)	使用Burst功能时，总带宽/读带宽/写带宽上限。
Burst Duration (second)	使用Burst功能时，按照Burst上限的能力进行操作所能持续的时间，单位是秒。上限项目依次为：读写操作次数、读操作次数、写操作次数、总带宽、读带宽、写带宽。
Create Time	QoS策略创建的时间。
Description	QoS策略的描述信息。
Storage Pool Name	卷所在的存储池名称。

智算服务

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

存储资源盘活系统

存储资源盘活系统

参数

示例

示例1

示例2

示例3

示例4

活动

智算服务

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

存储资源盘活系统

存储资源盘活系统

参数

示例

示例1

示例2

示例3

示例4