すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:list-object-versions

最終更新日:Aug 28, 2024

削除マーカーを含む、バケット内のすべてのオブジェクトのバージョンを一覧表示します。

使用上の注意

オブジェクトのバージョンを一覧表示するには、oss:ListObjectVersions権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

コマンド構文

ossutil api list-object-versions -- bucket value [flags]

パラメーター

データ型

説明

-- bucket

String

バケットの名前です。

-区切り文字

String

オブジェクトを名前でグループ化するために使用する文字。

-- encoding-type

String

レスポンス内のコンテンツのエンコードタイプ。

-- キーマーカー

String

key-markerパラメーターの値の後に名前がアルファベット順になっているオブジェクトを返します。 このパラメーターは、version-id-markerと共に指定できます。

-最大キー

int

返されるオブジェクトの最大数。

-- プレフィックス

String

返されるオブジェクトの名前に含める必要があるプレフィックス。

-- version-id-marker

String

キーマーカーで指定されたオブジェクトのバージョンID。 バージョンは最新バージョンから最も古いバージョンに返されます。

説明

詳細については、「コマンドラインオプション」をご参照ください。

  • examplebucketという名前のバケット内のすべてのオブジェクトのバージョンを一覧表示します。

    ossutil api list-object-versions -- bucket examplebucket
  • examplebucketという名前のバケット内のすべてのオブジェクトのバージョンを一覧表示し、出力をJSONでフォーマットします。

    ossutil api list-object-versions --bucket examplebucket --output-format json
  • examplebucketという名前のバケット内のすべてのオブジェクトのバージョンを一覧表示し、YAMLで出力をフォーマットします。

    ossutil api list-object-versions --bucket examplebucket --output-format yaml
  • examplebucketという名前のバケットに、"dir" という名前のプレフィックスを持つすべてのオブジェクトのバージョンを一覧表示します。

    ossutil api list-object-versions --bucket examplebucket --prefix dir
  • examplebucketという名前のバケットに、"dir" という名前のプレフィックスを持つ最初の100オブジェクトのバージョンを一覧表示します。

    ossutil api list-object-versions --bucket examplebucket --prefix dir --max-keys 100
  • 現在のディレクトリにあるすべてのオブジェクトのバージョンを、examplebucketという名前のバケットに一覧表示します。

    ossutil api list-object-versions -- bucket examplebucket -- delimiter /
  • examplebucketという名前のバケットで、名前が "test.txt" の後にアルファベット順になっているすべてのオブジェクトのバージョンを一覧表示します。

    ossutil api list-object-versions -- bucket examplebucket -- key-marker test.txt
  • examplebucketという名前のバケット内のすべてのオブジェクトのバージョンを一覧表示し、返されたオブジェクトの名前をURLエンコードします。

    ossutil api list-object-versions -- bucket examplebucket -- encoding-type url
  • examplebucketという名前のバケットに、test.txtオブジェクトの「123」バージョン以降のすべてのオブジェクトのバージョンを一覧表示します。

    ossutil api list-object-versions -- bucket examplebucket -- key-marker test.txt -- version-id-marker 123