分享对象

1. 在OBS管理控制台左侧导航栏选择“桶列表”。
2. 在OBS管理控制台桶列表中，单击待操作的桶，进入“对象”页面。
3. 选中待分享的文件，并单击右侧的“分享”，系统弹出如图1所示对话框。

   此时，链接信息中的链接就已经生效并开始计时，有效期为默认的5分钟。修改URL有效期，链接会相应变化，新链接的有效期从修改时开始计算。

   图1 分享文件
   

4. URL相关操作。
   • 单击“打开URL”，将在新页面打开文件进行预览或者直接下载文件到本地。
   • 单击“复制链接”，您可以将该链接分享给所有用户，用户可以在浏览器中通过此链接直接访问文件。
   • 单击“复制路径”，您可将该路径分享给所有拥有对象所在桶权限的用户，用户可以在对应桶中的文件搜索框中输入该路径搜索并访问文件。
   

   在“URL有效期”内，任何用户都可以访问该文件。

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参数指定生成目录。

参数说明：