tencent cloud

文档反馈

查询存储桶或文件列表 - ls

最后更新时间:2024-06-27 14:45:47
    ls 命令用于查询所有存储桶列表、查询存储桶下的文件列表和文件夹下的文件列表。

    命令格式

    ./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)
    说明
    --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: | 1
    ------------------+-----------------------

    列出文件

    列出 bucket1 存储桶中的所有文件

    ./coscli ls cos://bucket1
    返回的信息包括:对象键(对象在存储桶中的唯一标识),存储类型,最近更新时间,对象大小,对象总数。示例如下:
    KEY | TYPE | LAST MODIFIED | SIZE
    -----------------+----------+--------------------------+---------
    test.txt | STANDARD | 2022-01-01T00:00:00.000Z | 2 B
    -----------------+----------+--------------------------+---------
    TOTAL OBJECTS: | 1
    ---------------------------+---------

    列出 bucket1 存储桶中 picture 文件夹下的所有文件和文件夹

    ./coscli ls cos://bucket1/picture/
    普通列出仅返回查询路径所在层级的数据,不对子路径进行展开。示例如下:
    KEY | TYPE | LAST MODIFIED | SIZE
    -------------------+----------+--------------------------+---------
    picture/subfolder | DIR | |
    picture/pic1.png | STANDARD | 2022-01-01T00:00:00.000Z | 162 B
    -------------------+----------+--------------------------+---------
    TOTAL OBJECTS: | 2
    -----------------------------+---------

    递归列出 bucket1 存储桶中 picture 文件夹下的所有文件

    ./coscli ls cos://bucket1/picture/ -r
    如果查询路径所在层级有子路径,递归列出会对所有子路径进行扫描,返回查询路径层级下的所有文件。示例如下:
    KEY | TYPE | LAST MODIFIED | SIZE
    ----------------------------+----------+--------------------------+---------
    picture/subfolder/pic2.png | DIR | |
    picture/subfolder | DIR | |
    picture/pic1.png | STANDARD | 2022-01-01T00:00:00.000Z | 162 B
    ----------------------------+----------+--------------------------+---------
    TOTAL OBJECTS: | 2
    -----------------------------+---------

    递归列出 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
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持