You need to enable JavaScript to run this app.
导航

创建授权码(share-crt)

最近更新时间2024.02.29 20:16:17

首次发布时间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

待分享的对象名前缀,说明如下:

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

说明

设置该值时,建议以 / 结尾。

-vp

String

设置授权码的有效期,默认值为 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