signurl 命令用于获取某个对象的预签名 URL,可以通过此 URL 匿名访问对象。
命令格式
./coscli signurl cos://<bucket-name>/<key> [flag]
signurl 命令包含以下参数:
参数格式 | 参数用途 | 示例 |
cos://<bucket-name>/<key> | 使用桶别名访问:cos://example-alias/test.txt 使用桶名称访问:cos://examplebucket-1250000000/test.txt |
signurl 命令包含以下可选 flag:
flag 简写 | flag 全称 | flag 用途 |
-h | --help | 查看该命令的具体用法 |
-t | --time | 设置 URL 过期时间(默认1000s) |
无 | --simple-output | 启用简易输出模式,默认值为 false。当设置为 true 时,仅输出签名 URL,简化返回结果。 |
说明:
操作示例
获取 bucket1 桶内 picture.jpg 的预签名 URL
./coscli signurl cos://bucket1/picture.jpg
返回的结果示例如下:
INFO[2026-02-04 11:36:10] Signed URL:INFO[2026-02-04 11:36:10] https://bucket1-1234124.cos.ap-guangzhou.myqcloud.com/picture.jpg?q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1770176170%3B1770186170&q-key-time=1770176170%3B1770186170&q-header-list=host&q-url-param-list=&q-signature=****************************************
获取 bucket2 桶内 picture.jpg 的预签名 URL,并设置 URL 的过期时间为1314秒
./coscli signurl cos://bucket2/picture.jpg --time 1314
返回的结果示例如下:
INFO[2026-02-04 11:36:10] Signed URL:INFO[2026-02-04 11:36:10] https://bucket2-1234124.cos.ap-guangzhou.myqcloud.com/picture.jpg?q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1770176170%3B1770186170&q-key-time=1770176170%3B1770186170&q-header-list=host&q-url-param-list=&q-signature=****************************************
获取 bucket3 桶内 picture.jpg 的预签名 URL,并使用简易模式输出
./coscli signurl cos://bucket3/picture.jpg --simple-output
返回的结果示例如下:
https://bucket3-1234124.cos.ap-guangzhou.myqcloud.com/picture.jpg?q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1770176267%3B1770186267&q-key-time=1770176267%3B1770186267&q-header-list=host&q-url-param-list=&q-signature=****************************************