tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
对象存储
    文档
    Download PDF

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

    最后更新时间：2024-01-06 15:54:24
    下载PDF
      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 - 1000）
      说明
      --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 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款