全部文档
当前文档
最近更新时间：2025-06-20 16:57:40
sign命令用于该命令签名用户指定的cloud_url，生成经过签名的url可供第三方用户访问Object。
以下示例均以Linux为例。
./ks3util sign ks3://bucketname[/prefix]
[-r, --recursive]
[-f, --force]
[--include <value>]
[--exclude <value>]
[--timeout <value>]
[--sign-method <value>]
[--network-type <value>]参数 | 说明 |
|---|---|
bucketname | 操作的桶名。 |
prefix | 操作的对象的前缀。 |
-r, --recursive | 递归进行操作。当指定该选项时，会对存储空间下所有符合条件的对象进行操作，否则只对路径指定的定的单个对象进行操作。 |
-f, --force | 强制操作，不进行询问提示。 |
--include | 包含对象匹配模式，满足匹配规则的文件将会被选中，如：*.jpg。 该选项可以出现多次，多个--include规则取并集。 |
--exclude | 不包含对象匹配模式，满足匹配规则的文件将会被排除，如：*.txt。 该选项可以出现多次，多个--exclude规则取并集。 |
--timeout | 外链过期时间，默认值：10(单位秒) 。 |
--sign-method | 生成下载链接或者上传链接，默认值：get，可选值为 get 、put。 |
--network-type | 生成指定网络类型的链接，默认值：无，可选值：internal 、external。internal表示生成内网链接，external表示生成外网链接。 |
除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。
生成下载链接，单个签名默认 ‘GET’。
./ks3util sign ks3://samplebucket/src-prefix/sample.txt过期时间为签名时间+timeout时间。60秒后签名过期。
./ks3util sign ks3://samplebucket/src-prefix/sample.txt --timeout 60 生成上传链接。
./ks3util sign ks3://samplebucket/src-prefix/ -r --sign-method=PUT 批量签名目录。
./ks3util sign ks3://samplebucket/src-prefix/ -r 批量给符合匹配规则的文件签名。
./ks3util sign ks3://samplebucket/src-prefix -r --include *.txt生成内网链接。
./ks3util sign ks3://samplebucket/src-prefix/sample.txt --network-type internal生成外网链接。
./ks3util sign ks3://samplebucket/src-prefix/sample.txt --network-type external纯净模式