tencent cloud

バケットまたはファイルリストの照会 - ls
PDFファイルをダウンロード
最終更新日:2025-05-19 15:52:07
バケットまたはファイルリストの照会 - ls
最終更新日: 2025-05-19 15:52:07
PDFファイルをダウンロード
lsコマンドは、すべてのバケットリスト、バケット内のファイルリストおよびフォルダ内のファイルリストを照会するために使います。
注意：
ストレージバケット内のファイルを表示するには、ポリシー許可を設定する際に、actionをcos:HeadBucket、cos:GetBucketに設定する必要があります。
バージョン履歴情報を一覧表示するには（--all-versionsを渡す）、ポリシー許可を設定する際に、actionをcos:HeadBucket、cos:GetBucketVersioning、cos:GetBucketObjectVersionsに設定する必要があります。
アカウントのストレージバケットを表示するには、ポリシー許可を設定する際に、actionをcos:GetServiceに設定する必要があります。
詳細な権限については、CAM対応APIをご参照ください。

コマンド形式

./coscli ls [cos://<bucket-name>[/prefix/]] [flag]
lsコマンドには、次のオプションのパラメータが含まれます。
パラメータ形式
パラメータ用途
事例
cos://<bucket-name>
オプションのパラメータ。アクセスするバケットを指定します。パラメータ設定 のバケットの別名、またはバケット名を使用してアクセスすることがサポートされております。バケット名でアクセスする場合は、追加の endpoint flag が必要になります。
バケットの別名を使用してアクセスする場合：cos://example-aliasバケット名を使用してアクセスする場合：cos://examplebucket-1250000000
/prefix/
オプションのパラメータ。いずれかのフォルダを指定します
/picture/
lsコマンドには以下の選択可能なflagが含まれています：
flag略語
flag全称
flag用途
-h
--help
コマンドの具体的な使用方法を確認
なし
--include
特定モードのファイルを含む
なし
--exclude
特定モードのファイルを除外する
-r
--recursive
フォルダを再帰的に走査し、すべてのファイルを一覧表示するかどうかを設定
なし
--limit
リストアップの最大数を設定（0または未指定の場合はデフォルトで10000）
なし
--all-versions
オブジェクトのすべてのバージョンをリストします。これはバケットのバージョン管理を有効にした場合にのみ利用可能です。バージョン履歴のパラメータには、表示フィールドVersionId、IsLatest、Delete Markerが追加されます。
说明：
--include と --exclude は標準的な正規表現の構文をサポートしており、これを使えば特定の条件を満たすファイルをフィルタリングすることができます。
zshを使用する際、pattern文字列の両端に二重引用符を付ける必要がある場合があります。
./coscli ls cos://bucket1 -r --include ".*\\.mp4$"
このコマンドに関するその他の一般オプション（ストレージバケット・ユーザーアカウントの切り替えなど）については、一般オプション をご参照ください。

操作事例

現在のアカウント下のすべてのバケットを一覧表示します

./coscli ls
返される情報には、バケット名、リージョン、作成時間、ストレージバケット総数が含まれます。例として：
           BUCKET NAME          |     REGION      |     CREATE DATE
--------------------------------+-----------------+-----------------------
  examplebucket-1250000000      | ap-nanjing      | 2022-01-01T00:00:00Z
--------------------------------+-----------------+-----------------------
                                  TOTAL BUCKETS:  |          2
                                ------------------+-----------------------

ファイルの一覧表示

bucket1にあるすべてのファイルを一覧表示します

./coscli ls cos://bucket1
返される情報には、オブジェクトキー（ストレージバケット内のオブジェクトの唯一の識別子）、ストレージタイプ、最終更新時間、オブジェクトサイズ、オブジェクト総数が含まれます。例として：
     KEY     |   TYPE   |       LAST MODIFIED       |                ETAG                |      SIZE       | RESTORESTATUS  
-------------+----------+---------------------------+------------------------------------+-----------------+----------------
  test.txt   | STANDARD | 2024-06-05T15:03:37+08:00 | "a3bc6c9058109f8da48d41a5ab9abc7c" | 4.88 KB         |                
-------------+----------+---------------------------+------------------------------------+-----------------+----------------
                                                                                           TOTAL OBJECTS:  |       1        
                                                                                         ------------------+----------------

bucket1内のpictureフォルダにあるすべてのファイルとフォルダを一覧表示します

./coscli ls cos://bucket1/picture/
通常のリスト表示では、クエリパスのレベルのデータのみを返し、サブパスは展開しません。例として：
          KEY            |   TYPE   |       LAST MODIFIED       |                ETAG                |      SIZE       | RESTORESTATUS  
-------------------------+----------+---------------------------+------------------------------------+-----------------+----------------
  picture/a4431470f55662 | STANDARD | 2024-06-05T15:03:58+08:00 | "ed0430c5f27e76605e0555c260478112" | 358.00 B        |                
  picture/e98c6cefa4abd6 | STANDARD | 2024-06-05T15:03:58+08:00 | "bd5a4bd7248e7dfdb796383bee60470b" | 53.00 B         |                
-------------------------+----------+---------------------------+------------------------------------+-----------------+----------------
                                                                                                       TOTAL OBJECTS:  |       3        
                                                                                                     ------------------+----------------

ストレージバケットbucket1のpictureフォルダー配下にあるすべてのファイルを再帰的にリストアップします

./coscli ls cos://bucket1/picture/ -r
クエリパスのレベルにサブパスがある場合、再帰的にリストアップするとすべてのサブパスがスキャンされ、クエリパスレベル以下のすべてのファイルが返されます。例として：

         KEY                  |   TYPE   |       LAST MODIFIED       |                ETAG                |      SIZE       | RESTORESTATUS  
------------------------------+----------+---------------------------+------------------------------------+-----------------+----------------
 picture/subfolder            | DIR      |                           |                                    |                 |                
 picture/subfolder/pic2.png   | STANDARD | 2024-06-05T15:03:58+08:00 | "bd5a4bd7248e7dfdb796383bee60470b" | 53.00 B         |                
------------------------------+----------+---------------------------+------------------------------------+-----------------+----------------
                                                                                                       TOTAL OBJECTS:  |       3        
                                                                                                     ------------------+----------------

ストレージバケットbucket1内のすべての.mp4形式のファイルを再帰的にリストアップします

./coscli ls cos://bucket1 -r --include ".*\\.mp4$"

ストレージバケットbucket1内の.mp4形式以外のすべてのファイルを再帰的にリストアップします

./coscli ls cos://bucket1 -r --exclude ".*\\.mp4$"

ストレージバケットbucket1のpictureフォルダー配下にある、testで始まる、拡張子が.jpgではないすべてのファイルを再帰的にリストアップします

./coscli ls cos://bucket1/picture -r --include "^picture/test.*" --exclude ".*\\.jpg$"

バージョン履歴を表示

bucket1ストレージバケット内のすべてのバージョン履歴を表示

./coscli ls cos://bucket1/ -r --all-versions
クエリパスのレベルにサブパスがある場合、再帰的にリストアップするとすべてのサブパスがスキャンされ、クエリパスレベル以下のすべてのファイルのすべてのバージョン履歴が返されます。例として：
               KEY              |   TYPE   |          VERSIONID          | ISLATEST | DELETE MARKER |       LAST MODIFIED       |                ETAG                |  SIZE    
--------------------------------+----------+-----------------------------+----------+---------------+---------------------------+------------------------------------+----------
  cmd/cmd/abort.go              | STANDARD | MTg0NDUwMDM1MjIxMDM3MDI1MDM | false    | false         | 2025-02-26T14:33:25+08:00 | "c9bfc40db6669e9a7aee03abcd8b66e8" | 1.89 KB  
  cmd/cmd/abort_test.go         | STANDARD | MTg0NDUwMDM1MjIxMDM3MjgxODI | false    | false         | 2025-02-26T14:33:25+08:00 | "52166b1c60e4089a4652546c0350d2c7" | 4.89 KB  
  cmd/cmd/bucket_tagging.go     | STANDARD | MTg0NDUwMDM1MjIxMDM3MjY3MDI | false    | false         | 2025-02-26T14:33:25+08:00 | "edad62e08bf65a5bff81304e2b40ac1a" | 3.82 KB  
  cmd/cmd/bucket_versioning.go  | STANDARD | MTg0NDUwMDM1MjIxMDM2MTkzMzU | false    | false         | 2025-02-26T14:33:25+08:00 | "50a6b0e2e218c437ccdabe2c762aaef1" | 1.86 KB  
  cmd/cmd/buket_tagging_test.go | STANDARD | MTg0NDUwMDM1MjIxMDM2MTY4MDc | false    | false         | 2025-02-26T14:33:25+08:00 | "cd11257b22c9816df105da15f3ceb70f" | 8.23 KB  
  cmd/cmd/abort.go              |          | MTg0NDUwMDM1MjIwNjcyNTcxMDA | true     | true          | 2025-02-26T14:34:02+08:00 |                                    |          
  cmd/cmd/abort_test.go         |          | MTg0NDUwMDM1MjIwNjcxNzE5NDY | true     | true          | 2025-02-26T14:34:02+08:00 |                                    |          
  cmd/cmd/bucket_tagging.go     |          | MTg0NDUwMDM1MjIwNjcyNjczNzI | true     | true          | 2025-02-26T14:34:02+08:00 |                                    |          
  cmd/cmd/bucket_versioning.go  |          | MTg0NDUwMDM1MjIwNjY3ODc4NzM | true     | true          | 2025-02-26T14:34:02+08:00 |                                    |          
  cmd/cmd/buket_tagging_test.go |          | MTg0NDUwMDM1MjIwNjY3ODYyMDI | true     | true          | 2025-02-26T14:34:02+08:00 |                                    |          
--------------------------------+----------+-----------------------------+----------+---------------+---------------------------+------------------------------------+----------
                                                                                                                                           TOTAL OBJECTS:           |   10     
                                                                                                                                -------------------------------------+----------
この記事はお役に立ちましたか？
営業担当者に お問い合わせ いただくか チケットを提出 してサポートを求めることができます。
はい
いいえ

フィードバック