Setting Snapshot Expiration

IN THIS ARTICLE

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

REQUIREMENTS

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. 

DETAILS

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]

ADDITIONAL RESOURCES

QQ CLI: Snapshots