You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

复制全文
下载 pdf
分享对象
创建共享链接(share-crt)
复制全文
下载 pdf
创建共享链接(share-crt)
您可以通过 share-crt 命令,为需要分享的对象创建共享链接。​
命令格式​
​
Linux/macOS
Windows
​
​
./tosutil share-crt tos://bucket[/prefix] [-vp=xxx] [-dst=xxx] [-em] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]​
​
​
参数说明​
通用可选参数的说明,请参见通用可选参数。​
​
参数名​
参数类型​
描述​
bucket​
String​
待分享的对象所在的存储桶。​
prefix​
String​
待分享的对象名前缀,说明如下:​
  • 取值为空:表示分享整个桶内的对象。​
  • 取值不为空:表示分享以该前缀开头的所有对象。​
Tip​
  • 设置该参数时,建议以 / 结尾。​
  • 如果您希望通过浏览器或 TOS Browser 工具浏览分享的指定前缀的对象,则该参数必须以 / 结尾。​
-vp​
String​
设置共享链接的有效期,有效期取值范围为 1 分钟 ~ 7 天。如果您配置 tosutil 工具时使用的是临时访问密钥,则共享链接有效期可选最大值与临时访问密钥的过期时间保持一致。​
默认值为 1 天,表示生成的共享链接将在 1 天后失效,该参数支持以下配置方式:​
  • w:表示设置单位为周。​
  • d:表示设置单位为天。​
  • h:表示设置单位为小时。​
  • min:表示设置单位为分钟。​
  • s:表示设置单位为秒。​
例如 1d 表示有效期为 1 天,1w 表示有效期为 1 周,1h 表示有效期为 1 小时。​
Tip​
如果您没有选择时间单位,则默认单位为秒,例如 2400 表示有效期为2400秒。​
-dst​
String​
共享链接的保存路径。​
-em​
Bool​
设置精准匹配,表示仅分享单个对象。​
​
使用示例​
分享桶内所有对象​
以下命令用于分享 bucketname 桶内所有对象,共享链接有效期为 1 小时。​
  • 命令​
  • ​
    ./tosutil share-crt tos://bucketname -vp 1h ​
    ​
  • 返回​
  • ​
    Authorization Code:​
    https://document-share.tos-cn-beijing.volces.com/index.html?token=/****+aY3yfy+JmQ2Yd144VAZ5FuFbHru0ADVaY5wZkCUQMZYifSKe5n1IL2WqrqLb/bzYMKl2lqdIZPG8dBL4XEXeKE9SqtS4n+f17aaSIBU3B288ly9ANNBJ7eaBCni7/UKKpK49ZfXxm0mCdbS9sFTNahK5IAesDvAqMQis7wTxRrrqSRG2zGgabYgTNbRWD2OklttTJPtSA4940kisfHOEQwWBZol7MVarJItDqVEeiT80wLa3pr+5gb/8ZtWrBBfCOjAkEJY7AUmOSm5IMJsbhIzRhk9nV9ieDfSvJBGFaFg+vBjF7Xut2/pAEKozR2lKCoCKKZwI9BOJMnlCd15e9vlQfNeUVARqfhyTrVJJzX3wJfB/KTiA1MPQRtogaANfeHgOtPxu2gQzdPFX5kbRXAMmIEQHxZ/zOPR52AEWJSKLwDU/McV101wKuGIiQr90rs2izlMuEywF7g+cXftUmMvaMDQWehRpMRpxlI8kZMwVwJ/pbt3wi3/sNFgoSnnzvHxXY8dF/WsqVLUxOec3Qrd7l96bCY3Pd3yc742Mk7PO+VLOMIB//k****​
    ​
    Valid Until:​
    Tue, 06 Dec 2022 10:45:50 GMT​
    ​
分享桶内某个目录​
以下命令用于分享 bucketname 桶内 file 文件夹内的对象。​
  • 命令​
  • ​
    ./tosutil share-crt tos://bucketname/file/ ​
    ​
  • 返回​
  • ​
    Authorization Code:​
    https://document-share.tos-cn-beijing.volces.com/index.html?token=/****+aY3yfy+JmQ2Yd144VAZ5FuFbHru0ADVaY5wZkCUQMZYifSKe5n1IL2WqrqLb/bzYMKl2lqdIZPG8dBL4XEXeKE9SqtS4n+f17aaSIBU3B288ly9ANNBJ7eaBCni7/UKKpK49ZfXxm0mCdbS9sFTNahK5IAesDvAqMQis7wTxRrrqSRG2zGgabYgTNbRWD2OklttTJPtSA4940kisfHOEQwWBZol7MVarJItDqVEeiT80wLa3pr+5gb/8ZtWrBBfCOjAkEJY7AUmOSm5AfYxAXhJzE8QbKWhGZiLCzxD7N7cXUZuwLJ5NrM7Q9X06OxXwYoBDrS35B+3DEkjPBqI1AM/H9AFj62jTj35j4r83p8bWsElBcCiut8Vvdw7QXWiICDyFnNcmYR7C5J/iYUXhh9uDH7pjfeZkbKkV5heNwTIoA2Q3GozRPv966ktNJRBw0zN++P8n9ER7aRV7MgsoevwBQQCeC/KA47lQ34nf6uMmGum2wVIe9b4PCPoAOrYPW8h0eKfhnmkHLJEhaKPhvZISBH+9BQriBln73ASwbDt92FWwOqNF/vOH8UsxCsLzUxPd686st0PSSs****​
    ​
    Valid Until:​
    Tue, 06 Dec 2022 10:47:17 GMT​
    ​
分享桶内某个目录,并且指定共享链接的保存路径​
以下命令用于分享 bucketname 桶内 file 文件夹内的对象,共享链接路径为 /tmp/tosutil/authorization_code,共享链接生效时间为 2 小时。​
  • 命令​
  • ​
    ./tosutil share-crt tos://bucketname/file/ -dst=/tmp/tosutil/authorization_code -vp=2h​
    ​
  • 返回​
  • ​
    The result is generated to [/tmp/tosutil/authorization_code]​
    ​
分享桶内单个对象​
以下命令用于分享 bucketname 桶内 object1.png 对象。​
  • 命令​
  • ​
    ./tosutil share-crt tos://bucketname/object1.png -em​
    ​
  • 返回​
  • ​
    Authorization Code:​
    https://document-share.tos-cn-beijing.volces.com/index.html?token=/****+aY3yfy+JmQ2Yd144VAZ5FuFbHru0ADVaY5wZkCUQMZYifSKe5n1IL2WqrqLb/bzYMKl2lqdIZPG8dBL4XEXeKE9SqtS4n+f17aaSIBU3B288ly9ANNBJ7eaBCni7/UKKpK49ZfXxm0mCdbS9sFTNahK5IAesDvAqMQis7wTxRrrqSRG2zGgabYgTNbRWD2OklttTJPtSA4940kisfHOEQwWBZol7MVarJItDqVEeiT80wLa3pr+5gb/8ZtWrBBfCOjAkEJY7AUmOSm5DKH9vSYHHsx/NyPU4pOITmYALY8oDS2RmyGLwKV2MGv0dZSMViKFFVYn8M2mjXeadd1uvOFhXRjgj3jn1sJzyca9cgeCgH93dI6Tpa/DvZRdVY1IUhuCEX3ast2dhhsbSdzhmcV4PJ0jfxIvjdEGhYbp8wbfXVwJ028DBsvToRFpSIbr5fvYPAb2y7Wxp0AdXdUKXdWOtE2Ui9o+A8frSKcSAQxvW2EBLKoaL9GWQdrXhaYZtCLqd0TcOqr2d5GjuyJiMzqf9i5Wu98ydLsEYBiN8t1pbKOXuNMDbK/****​
    ​
    Valid Until:​
    Tue, 06 Dec 2022 10:48:12 GMT​
    ​
​
最近更新时间:2026.03.04 14:30:22
这个页面对您有帮助吗?
有用
有用
无用
无用