全部文档
当前文档

热搜词推荐

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

共搜索到 0 条结果

暂无内容

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

文档中心

对象存储(KS3)

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

列举分享文件（share-ls）

最近更新时间：2026-08-05 16:34:24

您可以通过 share-ls 命令，使用提取码列举分享的文件。

命令格式

直接通过分享链接列举对象
./ks3util share-ls authorization_code
[--prefix <value>]
[--access-code <value>]
[-s, --short-format] 
[-d, --directory] 
[--limited-num <value>] 
[--marker <value>] 
[--include <value>] 
[--exclude <value>]
[--time-range <value>]
[--only-current-dir]
[--readable]
[--list-parallel <value>]
[--list-depth <value>]
通过存放分享链接的文件路径列举文件
./ks3util share-ls file://authorization_code_file_url
[--prefix <value>]
[--access-code <value>]
[-s, --short-format] 
[-d, --directory] 
[--limited-num <value>] 
[--marker <value>] 
[--include <value>] 
[--exclude <value>]
[--time-range <value>]
[--only-current-dir]
[--readable]
[--list-parallel <value>]
[--list-depth <value>]

参数说明

参数

说明

authorization_code

需提取码的分享链接或直接分享链接。

file://authorization_code_file_url

存放分享链接的文件的具体位置。

必须以file://开头，后接存放分享链接的文件的绝对或相对路径，KS3 Util将会自动从文件中读取链接。

--prefix

列举指定前缀下的对象。若不指定则表示列举链接内的全部对象。

--access-code

分享链接的提取码，生成时未设置则无需指定。

1. 字符长度必须是6位，支持任意数字或字母组合，区分大小写。

2. 不指定该参数时会以交互模式提示输入提取码。

-s, --short-format

显示精简格式。

不指定该选项默认显示长格式。

-d, --directory

仅返回当前目录下的文件名称和子目录名称，而非递归返回当前目录及子目录下的全部文件名称。

--only-current-dir

仅返回当前目录下的文件具体信息和子目录名称，而非递归返回当前目录及子目录下的全部文件信息。

--only-current-dir和-s联合使用时，等效于-d选项。

--limited-num

限制返回结果的最大个数。

--marker

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

--readable

输出信息可读性优化展示，文件大小自适应合适的单位显示。

--include

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

  • 示例：*.jpg

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

--exclude

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

  • 示例：*.txt

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

--time-range

时间段匹配模式，仅匹配最后修改时间在该时间段内的文件。

  • 格式：time1-time2

1. time1、time2需要填写UTC时间，格式为：yyyyMMddHHmmss。

2. 详情请参见文档：通用选项&过滤规则。

--list-parallel

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

--list-depth

并行扫描的最大目录深度，默认值：1，取值范围：1-100。该值影响扫描策略，值越大并行扫描的目录层级越深，但不影响最终扫描到的文件总数。

使用示例

  1. 通过需提取码的分享链接列举文件。

    ./ks3util share-ls https://ks3.console.ksyun.com/doc-share.html?token=xxxxxxxxxxxx

    输出示例

    请输入提取码:
xxxxxx
The authorized prefix is [share-prefix/]
LastModifiedTime                                          Size(B)        StorageClass          ETAG                                                                              ObjectName
2025-05-12 15:32:39.573 +0800 CST       10240          STANDARD              294f5fd2c28bd8d3cb0e0edd19863c3b           ks3://samplebucket/share-prefix/part01/file00001
2025-05-12 15:32:39.435 +0800 CST       10240          STANDARD              68f5c47a094ab92b1fa4b945bafaf4dd              ks3://samplebucket/share-prefix/part01/file00002
Object Number is: 2
Object Size(B) is: 20480
The authorized prefix is [share-prefix/]

3.868516(s) elapsed

  2. 通过直接分享链接列举文件。

    ./ks3util share-ls http://samplebucket.ks3-cn-beijing.ksyuncs.com/?Expires=xxxxxx&KSSAccessKeyId=xxxxxx&Signature=xxxxxx&X-Kss-Policy=xxxxxx

    输出示例

    The authorized prefix is [share-prefix/]
LastModifiedTime                                          Size(B)        StorageClass          ETAG                                                                              ObjectName
2025-05-12 15:32:39.573 +0800 CST       10240          STANDARD              294f5fd2c28bd8d3cb0e0edd19863c3b           ks3://samplebucket/share-prefix/part01/file00001
2025-05-12 15:32:39.435 +0800 CST       10240          STANDARD              68f5c47a094ab92b1fa4b945bafaf4dd              ks3://samplebucket/share-prefix/part01/file00002
Object Number is: 2
Object Size(B) is: 20480
The authorized prefix is [share-prefix/]

3.868516(s) elapsed

  3. 通过存放分享链接的文件路径列举文件，所在位置为当前目录下的result.txt文件（相对路径）。

    ./ks3util share-ls file://result.txt

    假设文件的绝对路径为/home/user/result.txt，路径格式需写为file:///home/user/result.txt。

    输出示例

    请输入提取码:
xxxxxx
The authorized prefix is [share-prefix/]
LastModifiedTime                                          Size(B)        StorageClass          ETAG                                                                              ObjectName
2025-05-12 15:32:39.573 +0800 CST       10240          STANDARD              294f5fd2c28bd8d3cb0e0edd19863c3b           ks3://samplebucket/share-prefix/part01/file00001
2025-05-12 15:32:39.435 +0800 CST       10240          STANDARD              68f5c47a094ab92b1fa4b945bafaf4dd              ks3://samplebucket/share-prefix/part01/file00002
Object Number is: 2
Object Size(B) is: 20480
The authorized prefix is [share-prefix/]

3.868516(s) elapsed

  4. 通过分享链接列举文件，并使用--access-code指定提取码。

    此时不会再通过交互模式提示输入提取码。

    ./ks3util share-ls https://ks3.console.ksyun.com/doc-share.html?token=xxxxxxxxxxxx --access-code xxxxxx

    输出示例

    The authorized prefix is [share-prefix/]
LastModifiedTime                                          Size(B)        StorageClass          ETAG                                                                              ObjectName
2025-05-12 15:32:39.573 +0800 CST       10240          STANDARD              294f5fd2c28bd8d3cb0e0edd19863c3b           ks3://samplebucket/share-prefix/part01/file00001
2025-05-12 15:32:39.435 +0800 CST       10240          STANDARD              68f5c47a094ab92b1fa4b945bafaf4dd              ks3://samplebucket/share-prefix/part01/file00002
Object Number is: 2
Object Size(B) is: 20480
The authorized prefix is [share-prefix/]

3.868516(s) elapsed

  5. 通过分享链接列举share-prefix/part01/前缀下的文件。

    使用--prefix选项指定列举的前缀。

    ./ks3util share-ls https://ks3.console.ksyun.com/doc-share.html?token=xxxxxxxxxxxx --prefix share-prefix/part01/

    输出示例

    请输入提取码:
xxxxxx
The authorized prefix is [share-prefix/]
LastModifiedTime                                          Size(B)        StorageClass          ETAG                                                                              ObjectName
2025-05-12 15:32:39.573 +0800 CST       10240          STANDARD              294f5fd2c28bd8d3cb0e0edd19863c3b           ks3://samplebucket/share-prefix/part01/file00001
2025-05-12 15:32:39.435 +0800 CST       10240          STANDARD              68f5c47a094ab92b1fa4b945bafaf4dd              ks3://samplebucket/share-prefix/part01/file00002
Object Number is: 2
Object Size(B) is: 20480
The authorized prefix is [share-prefix/]

3.868516(s) elapsed

文档导读
上一篇：创建文件分享链接（share-create）
下一篇：下载分享文件（share-cp）
纯净模式常规模式

纯净模式

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