ls コマンドは、アカウント内のバケット、オブジェクト、パートに関する情報を一覧表示します。このコマンドを使用して、大きなファイルの検索や削除など、OSS リソースのクエリや管理ができます。
前提条件
バケットを一覧表示するには、
oss:ListBuckets権限が必要です。オブジェクトを一覧表示するには、
oss:ListObjects権限が必要です。オブジェクトのすべてのバージョンを一覧表示するには、
oss:ListObjectVersions権限が必要です。すべてのパートを一覧表示するには、
oss:ListPartsおよびoss:ListMultipartUploads権限が必要です。
詳細については、「RAM ユーザーへのカスタムアクセスポリシーの付与」をご参照ください。
コマンドフォーマット
ossutil ls [oss://bucket[/prefix]] [flags]オプション | タイプ | 説明 |
--all-versions | / | オブジェクトのすべてのバージョンを一覧表示します。 |
-d, --dirs | / | すべてのサブディレクトリ内のすべてのファイルを再帰的に一覧表示する代わりに、現在のディレクトリ内のファイルとサブディレクトリを一覧表示します。 |
--encoding-type | string | オブジェクト名またはファイル名のエンコーディングタイプを指定します。値は `url` に設定できます。 |
--end-with | string | 指定された値より辞書順で前にあるオブジェクトを一覧表示します。 |
--exclude | stringArray | パスまたはファイル名の除外ルールです。 |
--exclude-from | stringArray | ルールファイルから除外ルールを読み取ります。 |
--files-from | stringArray | ファイルからソースファイル名のリストを読み取ります。空行やコメント行は無視されます。 |
--files-from-raw | stringArray | ファイルからソースファイル名のリストを読み取ります。 |
--filter | stringArray | パスまたはファイル名のフィルタリングルールです。 |
--filter-from | stringArray | ルールファイルからフィルタリングルールを読み取ります。 |
-f, --force | / | 確認プロンプトなしで操作を強制実行します。 |
--include | stringArray | パスまたはファイル名の包含ルールです。 |
--include-from | stringArray | ルールファイルから包含ルールを読み取ります。 |
--limited-num | int | 返す結果の最大数です。 |
--list-objects | / | ListObjects API 操作を使用してオブジェクトを一覧表示します。 |
--max-size | SizeSuffix | 一覧表示するファイルの最大サイズを指定します。デフォルトの単位はバイトです。B、K、M、G、T、P などのサフィックスも使用できます。1 K (KiB) = 1024 B です。 |
--metadata-exclude | stringArray | オブジェクトのメタデータの除外ルールです。 |
--metadata-filter | stringArray | オブジェクトのメタデータのフィルタリングルールです。 |
--metadata-filter-from | stringArray | ルールファイルからオブジェクトのメタデータのフィルタリングルールを読み取ります。 |
--metadata-include | stringArray | オブジェクトのメタデータの包含ルールです。 |
--min-age | Duration | 指定された時間間隔より前に変更されたファイルのみを一覧表示します。デフォルトの単位は秒です。単位サフィックスも使用できます。たとえば、1h は 1 時間を示します。 説明
|
--max-age | Duration | 指定された時間間隔内に変更されたファイルのみを一覧表示します。デフォルトの単位は秒です。単位サフィックスも使用できます。たとえば、1h は 1 時間を示します。 説明
|
--min-mtime | Time | 指定された時刻以降に変更されたファイルのみを一覧表示します。時刻は UTC 形式である必要があります。例：2006-01-02T15:04:05。 説明
|
--max-mtime | Time | 指定された時刻より前に変更されたファイルのみを一覧表示します。時刻は UTC 形式である必要があります。例：2006-01-02T15:04:05Z。 |
--min-size | SizeSuffix | 一覧表示するファイルの最小サイズを指定します。デフォルトの単位はバイトです。B、K、M、G、T、P などのサフィックスも使用できます。1 K (KiB) = 1024 B です。 |
--multipart | / | 操作がバケット内の未完了のマルチパートアップロードイベントに適用されることを指定します。 |
--page-size | int | バッチ処理でページごとに一覧表示するオブジェクトの最大数です。デフォルト値：1000。有効な値：1～1000。 |
-r, --recursive | / | 操作を再帰的に実行します。このオプションを指定すると、コマンドはバケット内の一致するすべてのオブジェクトに対して実行されます。指定しない場合、コマンドは指定されたパス内のオブジェクトに対してのみ実行されます。 |
--request-payer | string | リクエストの支払方法です。リクエスト元支払いモードを使用する場合は、これを `requester` に設定します。 |
--short-format | / | 結果を短縮フォーマットで表示します。このオプションを指定しない場合、結果はデフォルトで詳細フォーマットで表示されます。 |
--start-after | string | 指定された値より辞書順で後にあるオブジェクトを一覧表示します。 |
--resource-group-id | string | リソースグループの ID を指定します。 |
詳細については、「コマンドラインオプション」をご参照ください。
利用例
すべてのバケットを一覧表示します。
ossutil ls`examplebucket` バケット内のすべてのオブジェクトを一覧表示します。
ossutil ls oss://examplebucket`examplebucket` バケット内のプレフィックスが `dir` のすべてのオブジェクトを一覧表示します。
ossutil ls oss://examplebucket/dir`examplebucket` バケットの `dir` フォルダ内にあるすべてのオブジェクトを直接一覧表示します。
ossutil ls oss://examplebucket/dir -d`examplebucket` バケット内のプレフィックスが `dir` の最初の 100 個のオブジェクトを一覧表示します。
ossutil ls oss://examplebucket/dir --limited-num 100`examplebucket` バケットの `dir1` および `dir2` フォルダ内のすべての `.txt` ファイルを一覧表示します。
ossutil ls oss://examplebucket/ --include "/dir1/**.txt" --include "/dir2/**.txt"`examplebucket` バケットの `dir1` および `dir2` フォルダ内で過去 3 日間に作成されたすべてのファイルを一覧表示します。
ossutil ls oss://examplebucket --include "/dir1/**" --include "/dir2/**" --max-age 3dすべてのバケットを一覧表示し、出力を JSON 形式で表示します。
ossutil ls --output-format json