全部文档
当前文档

热搜词推荐

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

共搜索到 0 条结果

暂无内容

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

文档中心

对象存储(KS3)

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

列举分享文件（share-ls）

最近更新时间：2025-10-15 11:39:31

您可以通过 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。

假设源目录为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=/ 进行扫描。

使用示例

示例一：通过分享链接列举文件
./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
示例二：通过分享链接存放的文件路径列举对象，文件路径为当前目录下的code.txt文件（相对路径）
./ks3util share-ls file://code.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
示例三：通过分享链接存放的文件路径列举对象，文件路径为/home/user/code.txt（绝对路径）
./ks3util share-ls file:///home/user/code.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
示例四：通过分享链接列举文件，并使用--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
示例五：通过分享链接列举指定前缀下的文件

使用--prefix选项指定列举前缀为share-prefix/part1/的对象。

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

输出示例

请输入提取码:
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，最大并发扫描深度为1。
./ks3util share-ls xxxxxxxxxxxx --list-parallel 5 --list-depth 1

输出示例

请输入提取码:
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://likui-test1/share-prefix/part01/file00001
2025-05-12 15:32:39.435 +0800 CST       10240      STANDARD   68f5c47a094ab92b1fa4b945bafaf4dd      ks3://likui-test1/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）
纯净模式常规模式

纯净模式

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