ls 命令用于查询所有存储桶列表、查询存储桶下的文件列表和文件夹下的文件列表。
命令格式
./coscli ls [cos://<bucket-name>[/prefix/]] [flag]
ls 命令包含以下参数：
参数格式 | 参数用途 | 示例 |
cos://<bucket-name> | 使用桶别名访问：cos://example-alias 使用桶名称访问：cos://examplebucket-1250000000 | |
/prefix/ | 可选参数。指定某一文件夹 | /picture/ |
ls 命令包含以下可选 flag：
flag 简写 | flag 全称 | flag 用途 |
-h | --help | 查看该命令的具体用法 |
无 | --include | 包含特定模式的文件 |
无 | --exclude | 排除特定模式的文件 |
-r | --recursive | 是否递归地遍历文件夹，并列出所有文件 |
无 | --limit | 指定列出的最大数量（传0或不传则默认为10000） |
说明：
--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
