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
    ./ossutil sign oss://bucket1/test.jpg --payer requester
    通过此URL访问产生的访问费用由生成文件URL的账号支付。

常用选项

您可以在使用sign命令时附加如下选项:
选项名称 描述
--timeout 设置文件URL的超时时间。单位为秒,默认值为60,取值范围为0~9223372036854775807。
--encoding-type 输入或者输出的Object名的编码方式,目前只支持url编码,即指定该选项时,取值为url。如果不指定该选项,则表示Object名未经过编码。Bucket名不支持url编码。
--loglevel 设置日志级别,默认为空,表示不输出日志文件。可选值为:
  • info:输出提示信息日志。
  • debug:输出详细信息日志(包括http请求和响应信息)。
--version-id 操作指定版本的Object,仅支持在已开启版本控制的Bucket内使用。
--trafic-limit 指定http的访问速度。单位:bit/s,缺省值为0(不受限制),取值范围为819200~838860800,即100KB/s~100MB/s。
--disable-encode-slash 表示不对url path中的正斜线(/)进行编码。
--payer requester 请求的支付方式,如果为请求者付费模式,可以将该值设置成requester。
说明 更多通用选项请参见查看选项