ossutilのlsコマンドを使用して、Alibaba Cloudアカウント内のObject Storage Service (OSS) バケット、オブジェクト、およびパーツを一覧表示できます。 たとえば、アカウント内の大きなオブジェクトを削除する場合は、最初にIsコマンドを使用してアカウント内のオブジェクトを一覧表示できます。
使用上の注意
バケットを一覧表示するには、
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操作を呼び出してオブジェクトを一覧表示します。 |
--max-age | 有効期間 | 最終変更時刻がこのオプションの値より前のオブジェクトを除外します。 デフォルトの単位はs (秒) です。 ミリ秒はms、秒はs、分はm、時間はh、日はd、週はw、月はM、年はyの単位で数値をサフィックスできます。 |
-- max-mtime | 時間 | 最終変更時刻がこのオプションの値より後のオブジェクトを除外します。 時刻は UTC である必要があります。 |
--max-size | SizeSuffix | 転送できるファイルまたはオブジェクトの最大サイズ。 デフォルトでは、サイズはバイト (B) 単位です。 数値に1024ベースの単位 (Bはbyte、KはKibibyte、MはMebibyte、GはGibibyte、TはTebibyte、PはPebibyte) でサフィックスを付けることができます。 |
--metadata-exclude | stringArray | オブジェクトメタデータの除外ルールを指定します。 |
-- metadata-filter | stringArray | オブジェクトメタデータのフィルタールール。 |
-- metadata-filter-from | stringArray | ファイルからメタデータフィルタールールを読み取ります。 |
-- metadata-include | stringArray | オブジェクトメタデータの包含ルールを指定します。 |
--min-age | 有効期間 | 最終変更時刻がこのオプションの値より後のオブジェクトを除外します。 デフォルトの単位はs (秒) です。 ミリ秒はms、秒はs、分はm、時間はh、日はd、週はw、月はM、年はyの単位で数値をサフィックスできます。 |
-- min-mtime | 時間 | 最終変更時刻がこのオプションの値より前のオブジェクトを除外します。 時刻は UTC である必要があります。 |
--min-size | SizeSuffix | 転送できるオブジェクトの最小サイズ。 デフォルトでは、サイズはバイト (B) 単位です。 数値に1024ベースの単位 (Bはbyte、KはKibibyte、MはMebibyte、GはGibibyte、TはTebibyte、PはPebibyte) でサフィックスを付けることができます。 |
-- multipart | / | バケット内の未完了のマルチパートタスクに操作を適用します。 |
--page-size | int | 1ページあたりに返すオブジェクトの最大数。 有効な値: 1 ~ 1000 デフォルト値は 1000 です。 |
-r, -- recursive | / | コマンドが操作を再帰的に実行することを指定します。 このオプションを指定した場合、コマンドはバケット内のすべての一致するオブジェクトに対して操作を実行します。 このオプションが指定されていない場合、コマンドは指定されたオブジェクトに対してのみ操作を実行します。 |
-- request-payer | String | リクエストの支払人。 pay-by-requesterが有効な場合は、このオプションを指定します。 有効値: requester。 |
--short-format | / | アイテムを短い形式で表示します。 このオプションを指定しない場合、長い形式が使用されます。 |
-- start-after | String | このオプションの値の後に名前が辞書形式であるオブジェクトと照合します。 |
詳細については、「コマンドラインオプション」をご参照ください。
例
アカウント内のすべてのバケットを一覧表示します。
ossutil lsexamplebucketバケット内のすべてのオブジェクトを一覧表示します。
ossutil ls oss:// examplebucketexamplebucketバケット内のプレフィックス "dir" を持つすべてのオブジェクトを一覧表示します。
ossutil ls oss:// examplebucket/direxamplebucketバケットの現在のディレクトリに、プレフィックス "dir" という名前のオブジェクトをすべて一覧表示します。
ossutil ls oss:// examplebucket/dir -dexamplebucketバケットに、プレフィックス "dir" という名前の最初の100オブジェクトを一覧表示します。
ossutil ls oss:// examplebucket/dir -- limited-num 100examplebucketバケットのルートディレクトリの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