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。
说明 更多通用选项请参见查看选项。