You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /对象存储/工具指南/tosutil/常用命令/分享对象/创建授权码（share-crt）
创建授权码（share-crt）
最近更新时间：2024.05.09 11:19:35首次发布时间：2023.01.12 20:36:47
我的收藏
有用
有用
无用
无用

您可以通过 share-crt 命令，为需要分享的对象创建授权码。

命令格式

./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

待分享的对象名前缀，说明如下：

  • 取值为空：表示分享整个桶内的对象。
  • 取值不为空：表示分享以该前缀开头的所有对象。

说明

  • 设置该参数时，建议以 / 结尾。
  • 如果您希望通过浏览器或 TOS Browser 工具浏览分享的指定前缀的对象，则该参数必须以 / 结尾。

-vp

String

设置授权码的有效期，有效期取值范围为 1 分钟 ~ 7 天。如果您配置 tosutil 工具时使用的是临时访问密钥，则授权码有效期可选最大值与临时访问密钥的过期时间保持一致。
默认值为 1 天，表示生成的授权码将在 1 天后失效，该参数支持以下配置方式：

  • w：表示设置单位为周。
  • d：表示设置单位为天。
  • h：表示设置单位为小时。
  • min：表示设置单位为分钟。
  • s：表示设置单位为秒。

例如 1d 表示有效期为 1 天，1w 表示有效期为 1 周，1h 表示有效期为 1 小时。

说明

如果您没有选择时间单位，则默认单位为秒，例如 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