分享对象

1. 在OBS管理控制台左侧导航栏选择“桶列表”。
2. 在OBS管理控制台桶列表中，单击待操作的桶，进入“对象”页面。
3. 选中待分享的文件，并单击右侧操作列的“分享”。
4. 在“分享文件”弹窗，设置URL有效期。
   • URL有效期范围为1分钟~18小时，有效期内任何用户都可以通过URL直接访问该对象。
   • 该弹窗打开时，链接信息已生效并开始计时，有效期默认为5分钟。修改URL有效期后会重新开始计时，同时链接信息会相应变化，您需要重新复制链接信息。
   图1 分享文件
   

5. 分享对象。
   • 单击“打开URL”，将在新页面打开对象进行预览或者直接下载对象到本地。
   • 单击“复制链接”，您可以将该链接分享给其他用户，用户可以在浏览器中通过此链接直接访问该对象。
   • 单击“复制路径”，您可将该路径分享给所有拥有对象所在桶权限的用户，用户可以在对应桶的对象列表页中部的搜索框中粘贴该路径并按“Enter”键，来搜索查看对象信息或访问对象。

URL中携带签名

1. 登录OBS Browser+。
2. 选中待配置的对象，单击需要共享的对象右侧的图标，如下图2、图3所示。
   图2 分享文件
   
   图3 分享文件夹
   

3. 单击“复制链接”，将该对象链接地址复制到浏览器中打开，即可访问该对象。
   

   对于存储类别为归档存储的桶中的对象，如果要让匿名用户通过URL访问，则需要先确认对象的状态是否为“已恢复”。

   基于安全合规要求，华为云对象存储服务OBS禁止通过OBS的默认域名在线预览桶内对象，即使用分享链接从浏览器访问桶内对象（如视频、图片、网页等）时，不会显示对象内容，而是以附件形式下载。解决方案请参考：如何在浏览器中在线预览OBS中的对象？

命令结构：

• Windows操作系统
  • 生成单个对象的下载链接

    obsutil sign obs://bucket/key [-e=300] [-config=xxx] [-endpoint=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

  • 按对象名前缀批量生成对象的下载链接

    obsutil sign obs://bucket[/key] -r [-e=300] [-timeRange=time1-time2] [-include=*.xxx] [-exclude=*.xxx] [-o=xxx] [-config=xxx] [-endpoint=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

• macOS/Linux操作系统
  • 生成单个对象的下载链接

    ./obsutil sign obs://bucket/key [-e=300] [-config=xxx] [-endpoint=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

  • 按对象名前缀批量生成对象的下载链接

    ./obsutil sign obs://bucket[/key] -r [-e=300] [-timeRange=time1-time2] [-include=*.xxx] [-exclude=*.xxx] [-o=xxx] [-config=xxx] [-endpoint=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例：

• 以Windows操作系统为例，运行obsutil sign obs://bucket-test/test.txt，生成单个对象下载链接。

  obsutil sign obs://bucket-test/test.txt
  
  Download url of [obs://bucket-test/test.txt] is:
    http://your-endpoint/bucket-test/test.txt?AccessKeyId=xxxx&Expires=1552548758&Signature=xxxx

• 以Windows操作系统为例，运行obsutil sign obs://bucket-test/test/ -r，批量生成对象下载链接。

  obsutil sign obs://bucket-test/test/ -r
  
  Generate download urls for objects . 
  
  Generate the download url(s) for the objects in the bucket [bucket-test] finished 
  Task id: af4dc692-6a88-4541-8156-ff1a889d2288

  

  • 由于可能存在对象数量庞大的场景，OBS Util会将对象的下载链接归档到结果清单文件目录下具体的文件，该文件名与Task Id相关联，比如上例的Task Id为af4dc692-6a88-4541-8156-ff1a889d2288，那么存在sign_succeed_report_{时间戳}_af4dc692-6a88-4541-8156-ff1a889d2288.txt文件。
  • 结果清单文件目录默认为用户目录的子文件夹.obsutil_output，也可以通过-o参数指定生成目录。

参数说明：