全部文档
当前文档
最近更新时间：2025-08-25 20:31:46
您可以通过 share-create 命令，为需要分享的文件创建分享链接。
./ks3util share-create ks3://bucketname[/prefix] [local_file]
[--access-code <value>]
[--valid-period <value>] 参数 | 说明 |
bucketname | 待分享文件所在的桶名。 |
prefix | 分享文件的前缀。  取值为空表示分享桶内所有文件，取值不为空表示分享该前缀下所有文件。 |
local_file | 分享链接保存的文件所在位置，如： 1. 若不指定该参数文件分享链接及过期时间将会输出在屏幕上，若指定该参数文件分享链接及过期时间将保存在该文件中。 2. 支持填写绝对路径和相对路径。 |
--access-code | 列举或下载分享文件的提取码。 1. 字符长度必须是6位，支持任意数字或字母组合，区分大小写。 2. 不指定该参数时会以交互模式提示输入提取码。 |
--valid-period | 分享链接的有效期，以当前时间为基准。
示例：3h表示三个小时内有效，1d表示一天内有效，2w表示两周内有效。 |
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 | 文件分享链接的过期时间。
超过该时间后分享链接将不可用。 |
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) elapsedshare-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) elapsedshare-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) elapsedshare-prefix/前缀下的全部文件创建分享链接，并设置链接保存至当前目录下名称为code.txt的文件内./ks3util share-create ks3://samplebucket/share-prefix/ code.txt输出示例
请输入提取码:
xxxxxx
The result is generated to [/home/user/util/code.txt]
2.193568(s) elapsed纯净模式