Skip to main content
Command reference

vserver object-store-server bucket snapshot show

Suggest changes
PDFs

Display a list of snapshots associated with the S3 bucket.

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The vserver object-store-server bucket snapshot show command displays information about snapshots created for S3 buckets.

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-vserver <vserver name>] - Vserver

If you specify this parameter, the command displays information only about the snapshots located for the specified Vserver.

[-bucket <TextNoCase>] - S3 Bucket Name

If you specify this parameter, the command displays information only about the snapshots located for the specified S3 buckets.

[-snapshot <TextNoCase>] - Snapshot Name

If you specify this parameter, the command displays information only snapshots matching the specified name.

[-create-time <Date>] - Snapshot Creation Time

If this parameter is specified, the command displays information only for the snapshots that match the specified creation time. The create time format is <day> <month> <day of month> <hour>:<min>:<sec> <year>.

[-instance-uuid <UUID>] - Snapshot Instance UUID

If this parameter is specified, the command displays information only for the snapshots that have the specified instance UUID.

Examples

The following example displays information for all snapshots associated with Vserver vs0.

cluster1::> vserver object-store-server bucket snapshot show
Vserver  Bucket     Snapshot                          Create Time
-------- ---------- --------------------------------- ------------------------
vs0      bucket     snap1                             Wed May 15 19:47:04 2024
vs0      bucket     snap2                             Thu May 16 03:21:26 2024
vs0      bucket     snap3                             Thu May 16 17:02:03 2024
3 entries were displayed.

The following example displays detailed information of the snapshots associated with Vserver vs0:

cluster1::> vserver object-store-server bucket snapshot show -instance
Vserver Name: vs0
             Bucket Name: bucket
           Snapshot Name: snap1
             Create Time: Wed May 15 19:47:04 2024
           Instance Uuid: 1639d804-5245-4a64-af89-093891b251a1
Vserver Name: vs0
             Bucket Name: bucket
           Snapshot Name: snap2
             Create Time: Thu May 16 03:21:26 2024
           Instance Uuid: dec5daf6-28f8-4eef-89f7-a9256de17d86
Vserver Name: vs0
             Bucket Name: bucket
           Snapshot Name: snap3
             Create Time: Thu May 16 17:02:03 2024
           Instance Uuid: aeed7372-a16f-4aad-8e23-708267a109fb
3 entries were displayed.

The following example displays information for all snapshots created at or after "Thu May 16 03:21:26 2024":

cluster1::> vserver object-store-server bucket snapshot show -create-time >="Thu May 16 03:21:26 2024"
Vserver  Bucket     Snapshot                          Create Time
-------- ---------- --------------------------------- ------------------------
vs0      bucket     snap2                             Thu May 16 03:21:26 2024
vs0      bucket     snap3                             Thu May 16 17:02:03 2024
2 entries were displayed.