Print Email PDF

Setting Snapshot Expiration


This article explains how to configure an expiration at a specified time to delete a snapshot automatically.


Qumulo Core 2.5.1 (or higher)

Note: Qumulo Core 2.6.6 adds Web UI support for deleting snapshots. For more information, see Taking Directory Snapshots on Demand or by Using a Snapshot Policy


When you create a snapshot by using the qq CLI, you can specify the time in UTC at which to delete the snapshot. If you don’t specify an expiration time, Qumulo Core doesn't delete the snapshot automatically.

The following is an example of creating a snapshot that expires at a specific time.

qq snapshot_create_snapshot --expiration 2022-12-31T00:00:00Z

The following is the output of this command.

  "id": 2,
  "name": "1_OnDemand",
  "timestamp": "2022-06-15T16:30:13.431594227Z",
  "source_file_id": "2",
  "policy_id": null,
  "expiration": "2022-12-31T00:00:00Z",
  "in_delete": false

To change or remove the expiration for existing snapshots, you can use the snapshot ID from the Web UI.

Note: The snapshot ID is the five-digit number at the beginning of the path string (for example, 63040_test homedir_test).

You can use the specific snapshot ID with the following command.

qq snapshot_modify_snapshot
  • To set the snapshot to never expire, you can use the following command.
    qq snapshot_modify_snapshot -i SNAPSHOT_ID -e ''
  • To have the snapshot expire in a specific amount of time in the future (1 hour, 1 month, 1 year, and so on), you can use the following command.
    qq snapshot_modify_snapshot -i SNAPSHOT_ID \
    -t [months,weeks,days,hours,minutes]


QQ CLI: Snapshots

Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.

Have more questions?
Open a Case
Share it, if you like it.