全部文档
当前文档

热搜词推荐

云服务器 虚拟私有网络 边缘节点计算 对等连接

共搜索到 0 条结果

暂无内容

如果没有找到您期望的内容，请尝试其他搜索词

文档中心

对象存储(KS3)

查看更多结果
未找到含当前关键字的文档标题
页面目录
全部展开全部收起
未找到含该关键词的产品
文档中心 对象存储(KS3) 常用工具 工具汇总 KS3Util命令行工具 桶操作 列举资源（ls）

列举资源（ls）

最近更新时间：2025-11-07 15:17:51

可以使用ls命令列举当前账号下的桶（Bucket）、对象（Object）和碎片（Part）信息。

以下示例均以Linux为例。

列举桶

命令格式

./ks3util ls 
[-s, --short-format] 
[--limited-num <value>]

参数说明

参数

说明

-s, --short-format

显示精简格式，如果未指定该选项，默认显示长格式。

--limited-num

返回结果的最大个数。

1. 除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。

2. 列举桶需具备ks3:ListBuckets权限。

使用示例

  • 列举所有的桶

    ./ks3util ls

    输出示例

    CreationTime                                             Region              StorageClass         BucketName
2021-12-02 17:03:21.811 +0800 CST        Region1             NORMAL              samplebucket1
2022-08-15 16:02:43.007 +0800 CST        Region2             NORMAL              samplebucket2
Bucket Number is: 2

0.112480(s) elapsed

  • 以精简模式列举所有桶

    ./ks3util ls -s

    输出示例

    ks3://sampleBucket1
ks3://sampleBucket2
ks3://sampleBucket3
Bucket Number is: 3

0.083726(s) elapsed

列举文件

命令格式

./ks3util ls ks3://bucketname[/prefix] 
[-s, --short-format] 
[-d, --directory] 
[--limited-num <value>] 
[--marker <value>] 
[--include <value>] 
[--exclude <value>]
[--time-range <value>]
[--only-current-dir]
[--only-current-key]
[--retention]
[--list-parallel <value>]
[--list-depth <value>]

参数说明

参数

说明

bucketname

目标桶名称。

prefix

目标Object前缀，当列举目标桶中指定前缀的Object时添加此项。

-s, --short-format

显示精简格式，如果未指定该选项，默认显示长格式。

-d, --directory

返回当前目录下的文件和子目录，而非递归显示所有子目录下的所有Object。

--limited-num

返回结果的最大个数。

--marker

列举名称字母排序在marker之后的Object。

--include

包含对象匹配模式，满足匹配规则的文件将会被选中，如：*.jpg。

该选项可以出现多次，多个--include规则取并集。

--exclude

不包含对象匹配模式，满足匹配规则的文件将会被排除，如：*.txt。

该选项可以出现多次，多个--exclude规则取并集。

--time-range

时间段匹配模式，仅匹配最后修改时间在该时间段内的文件。时间段格式为：time1-time2，其中time1、time2需要填写UTC时间，格式为：yyyyMMddHHmmss。

详细请参考通用选项&过滤规则文档。

--only-current-dir

只列举当前目录下的文件，不递归子目录。

--only-current-key

表示精确匹配与前缀相同的key，该选项必须和--retention选项一起使用，用于列出回收站中某个文件的全部版本。

--retention

指定回收站中的Object。使用该选项时，将无法使用--directory/--only-current-dir/--multipart选项。

--list-parallel

扫描文件的并发数，默认值：1，取值范围：1-100。

--list-depth

并行扫描的最大深度，超过此深度的目录将不再并行扫描，默认值：1，取值范围：1-100。

假设源目录为prefix/，而该目录存在以下结构：

prefix/aa/

prefix/aa/1/、prefix/aa/2/

prefix/bb/

prefix/bb/1/、prefix/bb/2/

值为 1 代表使用 delimiter=/ 扫描顶层（prefix/），获取到 prefix/aa/，prefix/bb/后，二者不再使用 delimiter=/ 进行扫描。

值为 2 代表获取到 prefix/aa/，prefix/bb/ 后，二者仍使用 delimiter=/ 进行扫描，再得到的结果不再使用 delimiter=/ 进行扫描。

1. 除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。

2. 列举桶内文件需具备ks3:ListBucket权限，列举回收站内文件需具备ks3:ListBucketRetention权限。

使用示例

  • 列举sampleBucket中的所有文件

    ./ks3util ls ks3://sampleBucket

    输出示例

    LastModifiedTime                                   Size(B)        StorageClass      ETAG                                                         ObjectName
2024-12-11 10:42:11.937 +0800 CST           0          STANDARD        d41d8cd98f00b204e9800998ecf8427e      ks3://sampleBucket/prefix/
2024-12-11 10:42:24.071 +0800 CST       10240      STANDARD        294f5fd2c28bd8d3cb0e0edd19863c3b      ks3://sampleBucket/prefix/file1
2024-12-11 10:42:29.806 +0800 CST       10240      STANDARD       68f5c47a094ab92b1fa4b945bafaf4dd         ks3://sampleBucket/prefix/file2
Object Number is: 3
Object Size is: 20480

0.138521(s) elapsed

  • 列举sampleBucket中前缀为abc的所有文件

    ./ks3util ls ks3://sampleBucket/abc

    输出示例

    LastModifiedTime                                    Size(B)         StorageClass      ETAG                                                          ObjectName
2024-12-11 10:43:17.677 +0800 CST           0             STANDARD        d41d8cd98f00b204e9800998ecf8427e      ks3://sampleBucket/abc/
2024-12-11 10:43:29.759 +0800 CST       10240         STANDARD        294f5fd2c28bd8d3cb0e0edd19863c3b      ks3://sampleBucket/abc/file1
2024-12-11 10:43:34.744 +0800 CST       10240         STANDARD        68f5c47a094ab92b1fa4b945bafaf4dd        ks3://sampleBucket/abc/file2
Object Number is: 3
Object Size is: 20480

0.142833(s) elapsed

  • 列举sampleBucket中的所有文件，设置扫描并发数为5，最大并发扫描深度为1

    ./ks3util ls ks3://sampleBucket --list-parallel 5 --list-depth 1

    输出示例

    LastModifiedTime                      Size(B)  StorageClass   ETAG                                  ObjectName
2024-12-11 10:42:11.937 +0800 CST           0      STANDARD   d41d8cd98f00b204e9800998ecf8427e      ks3://sampleBucket/prefix/
2024-12-11 10:42:24.071 +0800 CST       10240      STANDARD   294f5fd2c28bd8d3cb0e0edd19863c3b      ks3://sampleBucket/prefix/file1
2024-12-11 10:42:29.806 +0800 CST       10240      STANDARD   68f5c47a094ab92b1fa4b945bafaf4dd      ks3://sampleBucket/prefix/file2
Object Number is: 3
Object Size is: 20480

0.138521(s) elapsed

  • 列举sampleBucket中所有后缀名为.jpg的文件

    ./ks3util ls ks3://sampleBucket --include *.jpg

    输出示例

    LastModifiedTime                                     Size(B)     StorageClass   ETAG                                                           ObjectName
2024-12-11 10:44:27.862 +0800 CST       10240      STANDARD     294f5fd2c28bd8d3cb0e0edd19863c3b      ks3://sampleBucket/file1.jpg
2024-12-11 10:44:34.014 +0800 CST       10240      STANDARD     68f5c47a094ab92b1fa4b945bafaf4dd        ks3://sampleBucket/file2.jpg
Object Number is: 2
Object Size is: 20480

0.207725(s) elapsed

  • 仅列举sampleBucket根目录下所有Object和子目录

    ./ks3util ls ks3://sampleBucket -d

    输出示例

    ks3://sampleBucket/file1
ks3://sampleBucket/file2
ks3://sampleBucket/abc/
ks3://sampleBucket/prefix/
Object and Directory Number is: 4

0.518357(s) elapsed

创建的每个目录也会记为1个文件的数量。

  • 列举指定目录下的文件，不递归子目录

    ./ks3util ls ks3://sampleBucket/abc/ --only-current-dir

    输出示例

    LastModifiedTime                                     Size(B)     StorageClass     ETAG                                                           ObjectName
2025-02-13 14:15:27.682 +0800 CST       10240      STANDARD       294f5fd2c28bd8d3cb0e0edd19863c3b      ks3://sampleBucket/abc/file00001
2025-02-13 14:15:27.682 +0800 CST       10240      STANDARD       68f5c47a094ab92b1fa4b945bafaf4dd        ks3://sampleBucket/abc/file00002
-                                                                        -            -                                             -                                         ks3://sampleBucket/abc/prefix/
Object and Directory Number is: 3

0.236273(s) elapsed

  • 列举sampleBucket中最后修改时间在指定范围的文件

    ./ks3util ls ks3://sampleBucket --time-range "20241106120000-20241110120000"

    输出示例

    LastModifiedTime                                    Size(B)     StorageClass   ETAG                                                          ObjectName
2024-11-08 16:58:30.509 +0800 CST       10240      STANDARD    de1c8b02b6bdc042fb946f3eed1bdc64     ks3://bucket1/file1
2024-11-08 10:56:49.032 +0800 CST       10240      STANDARD    69fb7a4e8cecbe6ce034a8bbdf739249      ks3://bucket1/file2
Object Number is: 3
Object Size is: 20480

0.142833(s) elapsed

  • 列举回收站内文件

    • sampleBucket回收站中的所有文件

      ./ks3util ls ks3://sampleBucket --retention

      输出示例

      LastModifiedTime                                 Size(B)           StorageClass   ETAG                                                       RetentionId                                   RecycleTime                        EstimatedClearTime                 ObjectName
2025-01-09 10:23:11.663 +0800 CST  1468006400   STANDARD   dcbbd3323e6bfce0c8b9b2b808312657   29799610608337_Njc1NGYxYTgzZDIxNDI5ZmI5ZjczODFkMjQyODNhMzA=        2025-01-13 14:33:22.635 +0800 CST  2025-04-13 14:33:22.635 +0800 CST  ks3://sampleBucket/file1
2025-01-09 10:22:30.849 +0800 CST  1468006400   STANDARD   dcbbd3323e6bfce0c8b9b2b808312657   29799610649151_Njc1NGYxYTgzZDIxNDI5ZmI5ZjczODFkMjQyODNhMzA=        2025-01-09 10:23:04.931 +0800 CST  2025-04-09 10:23:04.931 +0800 CST  ks3://sampleBucket/file2
2025-01-09 10:17:49.196 +0800 CST  1468006400    STANDARD   dcbbd3323e6bfce0c8b9b2b808312657  29799610930804_Njc1NGYxYTgzZDIxNDI5ZmI5ZjczODFkMjQyODNhMzA=        2025-01-09 10:21:16.305 +0800 CST  2025-04-09 10:21:16.305 +0800 CST  ks3://sampleBucket/file3
Object Number is: 3
Object Size is: 4404019200

1.087084(s) elapsed

    • 列举sampleBucket回收站中的所有文件，并显示精简格式

      ./ks3util ls ks3://sampleBucket --retention -s

      输出示例

      RetentionId                                                                                                              ObjectName
29799610608337_Njc1NGYxYTgzZDIxNDI5ZmI5ZjczODFkMjQyODNhMzA=        ks3://sampleBucket/file1
29799610649151_Njc1NGYxYTgzZDIxNDI5ZmI5ZjczODFkMjQyODNhMzA=        ks3://sampleBucket/file2
29799610930804_Njc1NGYxYTgzZDIxNDI5ZmI5ZjczODFkMjQyODNhMzA=        ks3://sampleBucket/file3
Object Number is: 3
Object Size is: 4404019200

    • 列举sampleBucket回收站中前缀为abc的所有文件

      ./ks3util ls ks3://sampleBucket/abc --retention

      输出示例

      LastModifiedTime                                Size(B)           StorageClass   ETAG                                 RetentionId         RecycleTime                        EstimatedClearTime                 ObjectName
2025-01-09 10:23:11.663 +0800 CST  1468006400   STANDARD    dcbbd3323e6bfce0c8b9b2b808312657  29799610608337_Njc1NGYxYTgzZDIxNDI5ZmI5ZjczODFkMjQyODNhMzA=        2025-01-13 14:33:22.635 +0800 CST  2025-04-13 14:33:22.635 +0800 CST  ks3://sampleBucket/abc/file1
2025-01-09 10:22:30.849 +0800 CST  1468006400    STANDARD   dcbbd3323e6bfce0c8b9b2b808312657  29799610649151_Njc1NGYxYTgzZDIxNDI5ZmI5ZjczODFkMjQyODNhMzA=        2025-01-09 10:23:04.931 +0800 CST  2025-04-09 10:23:04.931 +0800 CST  ks3://sampleBucket/abc/file2
2025-01-09 10:17:49.196 +0800 CST  1468006400    STANDARD   dcbbd3323e6bfce0c8b9b2b808312657  29799610930804_Njc1NGYxYTgzZDIxNDI5ZmI5ZjczODFkMjQyODNhMzA=        2025-01-09 10:21:16.305 +0800 CST  2025-04-09 10:21:16.305 +0800 CST  ks3://sampleBucket/abc/file3
Object Number is: 3
Object Size is: 4404019200

1.087084(s) elapsed

    • 列举sampleBucket回收站中指定文件的全部版本

      ./ks3util ls ks3://sampleBucket/abc/test --retention --only-current-key

      输出示例

      LastModifiedTime                               Size(B)  StorageClass   ETAG                                  RetentionId             RecycleTime                        EstimatedClearTime                 ObjectName
2025-01-09 10:23:11.663 +0800 CST  1468006400      STANDARD   dcbbd3323e6bfce0c8b9b2b808312657      29799610608337_Njc1NGYxYTgzZDIxNDI5ZmI5ZjczODFkMjQyODNhMzA=        2025-01-13 14:33:22.635 +0800 CST  2025-04-13 14:33:22.635 +0800 CST  ks3://sampleBucket/file1
2025-01-09 10:22:30.849 +0800 CST  1468006400      STANDARD   dcbbd3323e6bfce0c8b9b2b808312657      29799610649151_Njc1NGYxYTgzZDIxNDI5ZmI5ZjczODFkMjQyODNhMzA=        2025-01-09 10:23:04.931 +0800 CST  2025-04-09 10:23:04.931 +0800 CST  ks3://sampleBucket/file1
2025-01-09 10:17:49.196 +0800 CST  1468006400      STANDARD   dcbbd3323e6bfce0c8b9b2b808312657      29799610930804_Njc1NGYxYTgzZDIxNDI5ZmI5ZjczODFkMjQyODNhMzA=        2025-01-09 10:21:16.305 +0800 CST  2025-04-09 10:21:16.305 +0800 CST  ks3://sampleBucket/file1
Object Number is: 3
Object Size is: 4404019200

1.087084(s) elapsed

    • 列举sampleBucket回收站中所有后缀名为.jpg的文件

      ./ks3util ls ks3://sampleBucket --retention --include "*.jpg"

      输出示例

      LastModifiedTime                      Size(B)  StorageClass   ETAG                                  RetentionId                           RecycleTime                        EstimatedClearTime                 ObjectName
2025-01-09 10:23:11.663 +0800 CST  1468006400      STANDARD   dcbbd3323e6bfce0c8b9b2b808312657      29799610608337_Njc1NGYxYTgzZDIxNDI5ZmI5ZjczODFkMjQyODNhMzA=        2025-01-13 14:33:22.635 +0800 CST  2025-04-13 14:33:22.635 +0800 CST  ks3://sampleBucket/file1.jpg
2025-01-09 10:22:30.849 +0800 CST  1468006400      STANDARD   dcbbd3323e6bfce0c8b9b2b808312657      29799610649151_Njc1NGYxYTgzZDIxNDI5ZmI5ZjczODFkMjQyODNhMzA=        2025-01-09 10:23:04.931 +0800 CST  2025-04-09 10:23:04.931 +0800 CST  ks3://sampleBucket/file2.jpg
2025-01-09 10:17:49.196 +0800 CST  1468006400      STANDARD   dcbbd3323e6bfce0c8b9b2b808312657      29799610930804_Njc1NGYxYTgzZDIxNDI5ZmI5ZjczODFkMjQyODNhMzA=        2025-01-09 10:21:16.305 +0800 CST  2025-04-09 10:21:16.305 +0800 CST  ks3://sampleBucket/file3.jpg
Object Number is: 3
Object Size is: 4404019200

1.087084(s) elapsed

列举未完成分块上传的Object信息

命令格式

./ks3util ls ks3://bucketname[/prefix] -m 
[-s, --short-format] 
[-d, --directory] 
[--limited-num <value>] 
[--marker <value>] 
[--include <value>] 
[--exclude <value>]

参数说明

参数

说明

bucketname

目标桶名称。

prefix

目标Object前缀，当列举目标桶中指定前缀的Object时添加此项。

-s, --short-format

显示精简格式，如果未指定该选项，默认显示长格式。

-d, --directory

返回当前目录下的文件和子目录，而非递归显示所有子目录下的所有Object。

--limited-num

返回结果的最大个数。

--marker

列举名称字母排序在marker之后的Object。

--include

包含对象匹配模式，满足匹配规则的文件将会被选中，如：*.jpg。

该选项可以出现多次，多个--include规则取并集。

--exclude

不包含对象匹配模式，满足匹配规则的文件将会被排除，如：*.txt。

该选项可以出现多次，多个--exclude规则取并集。

1. 除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。

2. 列举未完成分块上传的文件信息需具备ks3:ListBucketMultipartUploads权限。

使用示例

  • 列举sampleBucket中所有未完成分块上传的Object信息

    ./ks3util ls ks3://sampleBucket -m

    输出示例

    InitiatedTime                                         UploadID                                                  ObjectName
2024-12-11 11:54:45.277 +0800 CST    25123d10c0554a328ba4f196fba0daf5     ks3://sampleBucket/file1
2024-12-11 11:54:47.029 +0800 CST    89dae5783c9f4b7db6befd9634ec0812    ks3://sampleBucket/file2
UploadID Number is: 2

0.198764(s) elapsed

  • 列举sampleBucket中前缀为abc的所有未完成分块上传的Object信息

    ./ks3util ls ks3://sampleBucket/abc -m

    输出示例

    InitiatedTime                                         UploadID                                                   ObjectName
2024-12-11 11:54:45.277 +0800 CST    25123d10c0554a328ba4f196fba0daf5     ks3://sampleBucket/abc/file1
2024-12-11 11:54:47.029 +0800 CST    89dae5783c9f4b7db6befd9634ec0812    ks3://sampleBucket/abc/file2
UploadID Number is: 2

0.198764(s) elapsed

  • 列举sampleBucket中后缀为.jpg的所有未完成分块上传的Object信息

    ./ks3util ls ks3://sampleBucket -m --include *.jpg

    输出示例

    InitiatedTime                                         UploadID                                                   ObjectName
2024-12-11 11:54:45.277 +0800 CST    25123d10c0554a328ba4f196fba0daf5     ks3://sampleBucket/file1.jpg
2024-12-11 11:54:47.029 +0800 CST    89dae5783c9f4b7db6befd9634ec0812    ks3://sampleBucket/file2.jpg
UploadID Number is: 2

0.198764(s) elapsed

文档导读
上一篇：查看桶信息（stat）
下一篇：获取对象大小和数量（du）
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈