IGNITE-29056 Introduce snapshot lists command to control.sh

docs/_docs/snapshots/snapshots.adoc

@@ -287,6 +287,40 @@ control.(sh|bat) --snapshot restore snapshot_09062021 --groups cache-group1,cach
 control.(sh|bat) --snapshot restore snapshot_09062021 --increment 1
 ----
 
+== Listing Snapshots
+
+To list snapshots created on the cluster, use the following command.
+
+[tabs]
+--
+tab:Unix[]
+[source,shell]
+----
+# List all snapshots in the default snapshot directory.
+control.sh --snapshot list
+
+# List all snapshots in the "/tmp/ignite/snapshots" folder.
+control.sh --snapshot list --src /tmp/ignite/snapshots
+----
+
+tab:Windows[]
+[source,shell]
+----
+# List all snapshots in the default snapshot directory.
+control.bat --snapshot list
+
+# List all snapshots in the "C:\\tmp\\ignite\\snapshots" folder.
+control.bat --snapshot list --src C:\\tmp\\ignite\\snapshots
+----
+--
+
+=== List operation notes
+
+* The list operation is read-only and does not modify any snapshot data.
+* If a snapshot is being modified (created or deleted), its size might not be reported.
+* A snapshot is being detected by its metadata. If metadata is missing or cannot be read, snapshot is ignored.
+* When listing snapshots and calculating size, no additional snapshot validation or checksum calculation is performed.
+
 == Getting Snapshot Operation Status
 
 The status of the current snapshot operation in the cluster can be obtained using the `control.sh|bat` script or JMX interface:

modules/control-utility/src/test/java/org/apache/ignite/testsuites/IgniteControlUtilityTestSuite6.java

@@ -0,0 +1,32 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.ignite.testsuites;
+
+import org.apache.ignite.util.GridCommandHandlerListSnapshotTest;
+import org.junit.runner.RunWith;
+import org.junit.runners.Suite;
+
+/**
+ * Test suite for control utility.
+ */
+@RunWith(Suite.class)
+@Suite.SuiteClasses({
+    GridCommandHandlerListSnapshotTest.class
+})
+public class IgniteControlUtilityTestSuite6 {
+}

modules/control-utility/src/test/java/org/apache/ignite/util/GridCommandHandlerAbstractTest.java

@@ -499,6 +499,22 @@ protected void createCacheAndPreload(
     ) {
         assert nonNull(ignite);
 
+        CacheConfiguration<?, ?> ccfg = testCacheConfiguration(cacheName, partitions, filter);
+
+        ignite.createCache(ccfg);
+
+        try (IgniteDataStreamer<Object, Object> streamer = ignite.dataStreamer(cacheName)) {
+            for (int i = 0; i < countEntries; i++)
+                streamer.addData(i, i);
+        }
+    }
+
+    /** */
+    protected CacheConfiguration<?, ?> testCacheConfiguration(
+        String cacheName,
+        int partitions,
+        @Nullable IgnitePredicate<ClusterNode> filter
+    ) {
         CacheConfiguration<?, ?> ccfg = new CacheConfiguration<>(cacheName)
             .setAffinity(new RendezvousAffinityFunction(false, partitions))
             .setBackups(1)
@@ -507,12 +523,7 @@ protected void createCacheAndPreload(
         if (filter != null)
             ccfg.setNodeFilter(filter);
 
-        ignite.createCache(ccfg);
-
-        try (IgniteDataStreamer<Object, Object> streamer = ignite.dataStreamer(cacheName)) {
-            for (int i = 0; i < countEntries; i++)
-                streamer.addData(i, i);
-        }
+        return ccfg;
     }
 
     /**