API Doc
Search Docs...
⌘ K
OverviewDeploymentManagementOperationReferenceGlossary
    ACOS 6.3.0
  • Arcfra Cloud Operating System>
  • CLI command>
  • Managing block storage services>
  • Managing volume snapshots

Viewing volume snapshots

Viewing all volume snapshots

Users can view volume snapshots from all datastores, or all volume snapshots from a single datastore.

Procedure

Run the following command on any node in the cluster:

zbs-meta snapshot listall [pool_name]

pool_name: Name of the datastore. If this parameter is empty, snapshots from all datastores are displayed.

Output example

ID                                    Snap Name       Size      Perf Unique Size    Perf Shared Size    Cap Unique Size    Cap Shared Size    Logical Used Size    Diff Size    Volume Id                             Creation Time                  Description
------------------------------------  --------------  --------  ------------------  ------------------  -----------------  -----------------  -------------------  -----------  ------------------------------------  -----------------------------  ---------------------
22d70f1a-1372-4535-876e-2f629f623706  sp2             3.00 GiB  0.00 B              0.00 B              0.00 B             0.00 B             0.00 B               0.00 B       24fe0d76-1528-461a-b83f-db96f7b3d4a2  2024-06-17 18:45:47.147650126  snapshot-description2
a8ac78fc-9ca8-428e-b5e0-dde6a6955e35  snapshot-name7  3.00 GiB  0.00 B              512.00 MiB          0.00 B             0.00 B             256.00 MiB           0.00 B       057f5339-73e5-4b83-93f1-78a583649c50  2024-06-17 18:45:47.147465364
e1546006-bf0e-427a-ba7a-51fb24a1701f  snapshot1       3.00 GiB  0.00 B              512.00 MiB          0.00 B             0.00 B             256.00 MiB           0.00 B       057f5339-73e5-4b83-93f1-78a583649c50  2024-06-17 17:56:14.482402754

Output note

ParameterDescription
SizeThe logical size of the snapshot.
Perf Unique SizeThe performance tier exclusive space occupied by the snapshot.
Perf Shared SizeThe performance tier space shared by the snapshot and other objects.
Cap Unique SizeThe capacity tier exclusive space occupied by the snapshot.
Cap Shared SizeThe capacity tier space shared by the snapshot and other objects.
Logical Used SizeThe allocated logical space of the snapshot.

Viewing snapshots of a volume

Procedure

Run the following command on any node in the cluster to view snapshots of a specific volume:

zbs-meta snapshot list <pool_name> <volume_name>

Output example

ID                                    Snap Name       Size      Perf Unique Size    Perf Shared Size    Cap Unique Size    Cap Shared Size    Logical Used Size    Diff Size    Volume Id                             Creation Time                  Description
------------------------------------  --------------  --------  ------------------  ------------------  -----------------  -----------------  -------------------  -----------  ------------------------------------  -----------------------------  -------------
033ad13a-6d63-4e02-bfc5-2e1ca8e676ed  sp1             3.00 GiB  In Process          In Process          In Process         In Process         In Process           0.00 B       057f5339-73e5-4b83-93f1-78a583649c50  2024-06-18 14:42:05.810181135
a8ac78fc-9ca8-428e-b5e0-dde6a6955e35  snapshot-name7  3.00 GiB  In Process          In Process          In Process         In Process         In Process           0.00 B       057f5339-73e5-4b83-93f1-78a583649c50  2024-06-17 18:45:47.147465364
e1546006-bf0e-427a-ba7a-51fb24a1701f  snapshot1       3.00 GiB  In Process          In Process          In Process         In Process         In Process           0.00 B       057f5339-73e5-4b83-93f1-78a583649c50  2024-06-17 17:56:14.482402754

Output note

ParameterDescription
SizeThe logical size of the snapshot.
Perf Unique SizeThe performance tier exclusive space occupied by the snapshot.
Perf Shared SizeThe performance tier space shared by the snapshot and other objects.
Cap Unique SizeThe capacity tier exclusive space occupied by the snapshot.
Cap Shared SizeThe capacity tier space shared by the snapshot and other objects.
Logical Used SizeThe allocated logical space of the snapshot.

Viewing detailed information about a specified volume snapshot

Procedure

Run the following command on any node in the cluster to view detailed information about a specific volume snapshot:

zbs-meta snapshot show_by_id <snapshot_id>

Output example

-----------------  ------------------------------------
ID                 033ad13a-6d63-4e02-bfc5-2e1ca8e676ed
Name               sp1
Parent ID          057f5339-73e5-4b83-93f1-78a583649c50
Size               3.00 GiB
Perf Unique Size   0.00 B
Perf Shared Size   512.00 MiB
Cap Unique Size    0.00 B
Cap Shared Size    0.00 B
Logical Used Size  256.00 MiB
Creation Time      2024-06-18 14:42:05.810181135
Status             VOLUME_ONLINE
Resiliency Type    RT_REPLICA
Replica Num        3
EC Param
Thin Provision     True
Read Only          False
Description
Alloc Even         False
Clone count        0
Iops               0
Iops Read          0
Iops Write         0
Bps                0
Bps Read           0
Bps Write          0
Stripe Num         1
Stripe Size        262144
Prefer CID         0
Access Points      [1]
Is Prioritized     False
Downgraded PRS     0.00 B
-----------------  ------------------------------------

Output note

ParameterDescription
SizeThe logical size of the snapshot.
Perf Unique SizeThe performance tier exclusive space occupied by the snapshot.
Perf Shared SizeThe performance tier space shared by the snapshot and other objects.
Cap Unique SizeThe capacity tier exclusive space occupied by the snapshot.
Cap Shared SizeThe capacity tier space shared by the snapshot and other objects.
Logical Used SizeThe allocated logical space of the snapshot.
Resiliency TypeThe redundancy mode.
Replica NumThe replication factor in replication redundancy mode.
EC ParamThe EC parameters in EC redundancy mode.
Thin ProvisionWhether it is thin-provisioned.
Read OnlyWhether the snapshot is read-only.
Alloc Even Whether replicas are evenly distributed.
Access PointsThe access points for snapshots.
Is PrioritizedWhether to keep all snapshot data in the performance tier.
Downgraded PRSThe snapshot space not yet promoted to the performance tier.