sign命令用于生成经过签名的url供第三方用户访问存储空间(Bucket)内的对象(Object)。
说明
- 本文命令均以Linux系统为例,实际使用时,请将命令名称改为您实际可执行程序文件的名称。例如Windows 32位系统的帮助命令为ossutil32.exe help。
- 关于文件URL的介绍请参见上传Object后如何获取访问URL?。
命令格式
./ossutil sign oss://bucket/object [--timeout t] [--version-id versionId] [--trafic-limit limitSpeed] [--disable-encode-slash] [--payer requester]
- --timeout:设置文件URL的超时时间。单位为秒,默认值为60,取值范围为0~9223372036854775807。
- --trafic-limit:指定http的访问速度。单位:bit/s,缺省值为0(不受限制),取值范围为819200~838860800,即100KB/s~100MB/s。
使用示例
- 生成默认超时时间的文件URL,默认超时时间为60秒
./ossutil sign oss://bucket/path/object
- 生成指定超时时间的文件URL
./ossutil sign oss://bucket/path/object --timeout 3600
- 生成指定访问速度的文件URL
./ossutil sign oss://bucket/path/object --trafic-limit 8388608
说明 单位换算公式:1MByte=1024KByte=1048576Byte=8388608bit - 在已开启版本控制的Bucket内,为指定版本Object生成文件URL
在使用./ossutil sign oss://bucket1/test.jpg --timeout 3600 --version-id CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk
--version-id
选项前,需使用ls --all-versions命令获取文件的versionid。说明--version-id
选项仅支持在已开启版本控制的Bucket内使用。开启Bucket版本控制命令请参见bucket-versioning。 - 在已开启请求者付费模式的Bucket内,为指定Object生成文件URL
通过此URL访问产生的访问费用由生成文件URL的账号支付。./ossutil sign oss://bucket1/test.jpg --payer requester
常用选项
您可以在使用sign命令时附加如下选项:
选项名称 | 描述 |
---|---|
--timeout | 设置文件URL的超时时间。单位为秒,默认值为60,取值范围为0~9223372036854775807。 |
--encoding-type | 输入或者输出的Object名的编码方式,目前只支持url编码,即指定该选项时,取值为url。如果不指定该选项,则表示Object名未经过编码。Bucket名不支持url编码。 |
--loglevel | 设置日志级别,默认为空,表示不输出日志文件。可选值为:
|
--version-id | 操作指定版本的Object,仅支持在已开启版本控制的Bucket内使用。 |
--trafic-limit | 指定http的访问速度。单位:bit/s,缺省值为0(不受限制),取值范围为819200~838860800,即100KB/s~100MB/s。 |
--disable-encode-slash | 表示不对url path中的正斜线(/)进行编码。 |
--payer requester | 请求的支付方式,如果为请求者付费模式,可以将该值设置成requester。 |
说明 更多通用选项请参见查看选项。