6.2.8.7 lssnapshots

ファイルに関連付けられたスナップショットをリストします。

用途

lssnapshotsコマンドは、指定されたファイルに関連付けられたスナップショットに関する情報を表示します。

構文

lssnapshots filename { --all | --tree | [ -l ] [ --detail ] [ --attributes attribute[,attribute] ... ] 
     [ --filter filter[,filter] ... ] [ --count value ] }

コマンド・オプション

lssnapshotsコマンドのオプションは、次のとおりです:

  • filename: コマンドの対象となるファイルを識別します。指定するファイルは、スナップショット、クローン、通常ファイルのいずれかです。

  • --all: 指定されたファイルを含むスナップショット・ツリーに属するすべてのファイル、クローンおよびスナップショットに関する情報をリストします。出力は、一連のリストで表示されます。最初のリストには、スナップショット・ツリー内のファイルおよびクローンが含まれます。残りの出力には、ソース・ファイル別にグループ化されたスナップショットがリストされます。

  • --tree: 指定されたファイルを含むスナップショット・ツリーに属するすべてのファイル、クローンおよびスナップショットに関する情報をリストします。出力はグラフィカル・ツリー内に配置されます。

  • -l: 出力を長い表形式で返します。

  • --detail: すべての属性を詳細な形式でリストします。

  • --attributes: 表示する特定の属性をリストします。

  • --filter: 出力をフィルタ処理するための条件の指定に使用されます。

  • --count: レポートする結果の最大数を指定します。

使用上のノート

このコマンドを使用する際は、次の情報に注意してください:

  • コマンド・オプション--allまたは--treeを指定しない場合、指定されたソース・ファイルの即時スナップショットに関する情報が表示されます。

  • 他のコマンド・オプションは、--allまたは--treeと組み合せて使用することはできません。

  • フィルタは、<attribute><operator><value>として指定します。

    属性には、ファイル属性、またはvault.接頭辞が付いたボールト属性を指定できます。複数のフィルタ条件はカンマで区切られます。

    使用可能な演算子は、=、>=、<=、>および<です。

    日付は、次の書式を使用して指定できます:

    • yyyy-MM-dd''T''HH:mm:ss
    • yyyy-MM-dd (時間は午前00:00と見なされます)
    • HH:mm:ss (日付は本日と見なされます)

    これらの形式の後に、タイムゾーン指定を続けることができます。

    ファイル・サイズは、接尾辞K、KB、M、MB、G、GB、T、TBを使用して指定できます。接尾辞は、大/小文字が区別されません。

    たとえば、今日の正午後に作成され、サイズが10 MBを超えるスナップショットのみが表示されるように結果をフィルタ処理するには、次を使用します:

    --filter creationTime>12:00:00,size>10M

  • 出力は、スナップショット作成時間に従って、最新のものから順に並べられます。

例

例6-95 基本的なスナップショット情報のリスト

次の例では、指定されたファイルに基づくすべてのスナップショットに関する情報をリストする方法を示します。

@> lssnapshots @MYDATA/x

例6-96 詳細なスナップショット情報のリスト

次の例では、指定されたファイルに基づくすべてのスナップショットに関する詳細情報をリストする方法を示します。

@> lssnapshots @MYDATA/x --detail

例6-97 特定の属性を持つスナップショット情報のリスト

次の例では、指定されたファイルに基づくすべてのスナップショットについて特定の属性をリストする方法を示します。

@> lssnapshots @MYDATA/x --detail --attributes name,vault.name,createTime,vault.createTime

例6-98 スナップショットのリストのフィルタ処理

次の例では、コマンド出力を制約するフィルタを指定する方法を示します。この例では、出力は、指定された日付より後に作成されたスナップショットに制限されています。

@> lssnapshots @MYDATA/x --filter createTime>2020-01-01

例6-99 最新のスナップショットのリスト

次の例では、コマンド出力を制約するカウントを指定する方法を示します。この例では、出力は、最近作成された5つのスナップショットに制限されています。

@> lssnapshots @MYDATA/x --count 5

例6-100 スナップショット・ツリーの表示

この例のコマンド出力では、次のコマンド・シーケンスを使用して作成された関連ファイルのグループを想定しています:

@TEST/> putfile somelocalfile file1
Putting file somelocalfile to @TEST/file1
Success.

@TEST/> snapshotfile file1 snap1_of_file1
Success.

@TEST/> clonefile file1 clone1
Success.

@TEST/> snapshotfile file1 snap2_of_file1
Success.

@TEST/> snapshotfile clone1 snap1_of_clone1
Success.

次の例では、--treeコマンド・オプションを使用して、スナップショット・ツリー内のすべてのファイルを表示する方法を示します。 

@> lssnapshots @TEST/clone1 --tree

+---- [1] @TEST/snap1_of_file1
+---- [2] @TEST/?8000_0000_000a:00000001
|
|`---+---- [4] @TEST/snap1_of_clone1
|    +---- [6] @TEST/clone1
|
+---- [3] @TEST/snap2_of_file1
+---- [5] @TEST/file1

コマンド出力には、@TEST/clone1を作成するクローニング操作の一環として暗黙的に作成された内部スナップショット(@TEST/?8000_0000_000a:00000001)が含まれていることに注意してください。

例6-101 スナップショット・ツリー内のすべてのファイルのリスト

次の例では、--allコマンド・オプションを使用して、スナップショット・ツリー内のすべてのファイルを表示する方法を示します。この例では、前の例と同じシナリオを想定しています。 

@> lssnapshots @TEST/clone1 --all

---FILE/CLONES:---

2022-05-02 06:14:41 UTC @TEST/file1
2022-05-02 06:15:15 UTC @TEST/clone1

---SNAPSHOTS:---

@TEST/file1
  2022-05-02 06:15:06 UTC @TEST/snap1_of_file1
  2022-05-02 06:15:15 UTC @TEST/?8000_0000_000a:00000001
  2022-05-02 06:15:24 UTC @TEST/snap2_of_file1

@TEST/clone1
  2022-05-02 06:15:45 UTC @TEST/snap1_of_clone1

親トピック: ファイル管理