全部文档
当前文档
最近更新时间：2026-08-05 16:34:24
您可以通过 share-create 命令，为需要分享的文件创建分享链接。
./ks3util share-create ks3://bucketname[/prefix] [local_file]
[--access-code <value>]
[--valid-period <value>]
[-f, --force] 参数 | 说明 |
bucketname | 待分享文件所在的桶名。 |
prefix | 分享文件的前缀。  取值为空表示分享桶内所有文件，取值不为空表示分享该前缀下所有文件。 |
local_file | 分享链接保存的文件所在位置，如： 1. 若不指定该参数，文件分享链接及过期时间将会输出在屏幕上；若指定该参数，文件分享链接及过期时间将保存在该文件中。 2. 支持填写绝对路径和相对路径。 |
--access-code | 分享链接的提取码，设置后需输入提取码方可访问，未设置则直接分享。 1. 长度必须是6位，支持任意数字或字母组合，区分大小写。 2. 不指定该参数时会以交互模式提示输入提取码。 |
--valid-period | 分享链接的有效期，以当前时间为基准。
示例：3h表示三个小时内有效，1d表示一天内有效，2w表示两周内有效。 |
-f, --force | 强制操作，不进行交互式询问。与 |
为samplebucket桶下的全部文件创建需提取码的分享链接。
./ks3util share-create ks3://samplebucket输出示例
请输入提取码（直接回车表示不设置提取码）:
xxxxxx
Authorization Code:
https://ks3.console.ksyun.com/doc-share.html?token=xxxxxxxxxxxx
Access Code:
xxxxxx
Valid Until:
Tue, 13 May 2025 15:10:26 GMT +0800
4.157893(s) elapsed输出结果说明
字段名称 | 说明 |
|---|---|
Authorization Code | 携带授权信息的文件分享链接。 可将该链接地址复制到浏览器中列举或下载文件，或使用KS3 Util工具列举或下载文件。 |
Access Code | 列举或下载分享文件需要输入的提取码。 通过分享链接获取文件时必须先指定提取码。 |
Valid Until | 文件分享链接的过期时间。
超过该时间后分享链接将不可用。 |
为samplebucket桶下的全部文件创建直接分享链接。
./ks3util share-create ks3://samplebucket输出示例
请输入提取码（直接回车表示不设置提取码）:
Authorization Code:
http://samplebucket.ks3-cn-beijing.ksyuncs.com/?Expires=xxxxxx&KSSAccessKeyId=xxxxxx&Signature=xxxxxx&X-Kss-Policy=xxxxxx
Valid Until:
Tue, 13 May 2025 15:10:26 GMT +0800
4.157893(s) elapsed为samplebucket桶的share-prefix/前缀下的文件创建需提取码的分享链接。
./ks3util share-create ks3://samplebucket/share-prefix/输出示例
请输入提取码（直接回车表示不设置提取码）:
xxxxxx
Authorization Code:
https://ks3.console.ksyun.com/doc-share.html?token=xxxxxxxxxxxx
Access Code:
xxxxxx
Valid Until:
Tue, 13 May 2025 15:10:26 GMT +0800
4.157893(s) elapsed为samplebucket桶的share-prefix/前缀下的文件创建需提取码的分享链接，并使用--valid-period设置链接有效期为7天。
./ks3util share-create ks3://samplebucket/share-prefix/ --valid-period 7d输出示例
请输入提取码（直接回车表示不设置提取码）:
xxxxxx
Authorization Code:
https://ks3.console.ksyun.com/doc-share.html?token=xxxxxxxxxxxx
Access Code:
xxxxxx
Valid Until:
Mon, 19 May 2025 15:24:34 GMT +0800
4.157893(s) elapsed为samplebucket桶的share-prefix/前缀下的文件创建需提取码的分享链接，并使用--access-code指定提取码为123456。
此时不会再通过交互模式提示输入提取码。
./ks3util share-create ks3://samplebucket/share-prefix/ --access-code 123456输出示例
Authorization Code:
https://ks3.console.ksyun.com/doc-share.html?token=xxxxxxxxxxxx
Access Code:
123456
Valid Until:
Tue, 13 May 2025 15:10:26 GMT +0800
4.157893(s) elapsed为samplebucket桶的share-prefix/前缀下的文件创建需提取码的分享链接，并将结果保存至result.txt文件内。
./ks3util share-create ks3://samplebucket/share-prefix/ result.txt输出示例
请输入提取码（直接回车表示不设置提取码）:
xxxxxx
The result is generated to [/home/user/result.txt]
2.193568(s) elapsed纯净模式