PowerScaleOneFS CLI Command Reference

Syntax

isi snapshot snapshots list 
  [--state (all | active | deleting)]
  [{--limit | -l} <integer>]
  [--sort (id | name | path | has_locks | schedule | target_id | target_name | created | expires | size | shadow_bytes | pct_reserve | pct_filesystem | state)]
  [{--descending | -d}]
  [--format (table | json | csv | list)]
  [{--no-header | -a}]
  [{--no-footer | -z}]
  [{--verbose | -v}]

Options

--state <state>

Displays only snapshots and snapshot aliases that exist in the specified state.

The following states are valid:

all

Displays all snapshots and snapshot aliases that are currently occupying space on the cluster.

active

Displays only snapshots and snapshot aliases that have not been deleted.

deleting

Displays only snapshots that have been deleted but are still occupying space on the cluster. The space occupied by deleted snapshots will be freed the next time the snapshot delete job is run.

{--limit | -l} <integer>

Displays no more than the specified number of items.

--sort <attribute>

Sorts command output by the specified attribute.

The following attributes are valid:

id

Sorts output by the ID of a snapshot.

name

Sorts output alphabetically by the name of a snapshot.

path

Sorts output by the absolute path of the directory contained in a snapshot.

has_locks

Sorts output by whether any snapshot locks have been applied to a snapshot.

schedule

If a snapshot was generated according to a schedule, sorts output alphabetically by the name of the snapshot schedule.

target_id

If a snapshot is an alias, sorts output by the snapshot ID of the target snapshot instead of the snapshot ID of the alias.

target_name

If a snapshot is an alias, sorts output by the name of the target snapshot instead of the name of the alias.

created

Sorts output by the time that a snapshot was created.

expires

Sorts output by the time at which a snapshot is scheduled to be automatically deleted.

size

Sorts output by the amount of disk space taken up by a snapshot.

shadow_bytes

Sorts output based on the amount of data that a snapshot references from shadow stores. Snapshots reference shadow store data if a file contained in a snapshot is cloned or a snapshot is taken of a cloned file.

pct_reserve

Sorts output by the percentage of the snapshot reserve that a snapshot occupies.

pct_filesystem

Sorts output by the percent of the file system that a snapshot occupies.

state

Sorts output based on the state of snapshots.

{--descending | -d}

Displays output in reverse order.

--format {table | json | csv | list}

Displays output in table (default), JavaScript Object Notation (JSON), comma-separated value (CSV), or list format.

{--no-header | -a}

Displays table output without headers.

{--no-footer | -z}

Displays table output without footers. Footers display snapshot totals, such as the total amount of storage space consumed by snapshots.

{--verbose | -v}

Displays more detailed information.