分享文件夹

使用场景

实际业务场景下，您可能会需要将整个文件夹临时分享给其他人或者将文件夹永久共享给其他人。

• 临时分享：

  通过文件夹的临时URL直接将其分享给其他用户。文件夹分享强调临时性，所有分享的URL都是临时URL，存在有效期。

  临时分享分为两种方式：提取码分享、直接分享。

  提取码分享

  分享者需要先设置一个6位数的提取码，再创建分享。创建成功后，OBS会自动将文件夹中的所有对象的下载链接汇总到一个静态网站中，并托管到一个公共的OBS桶。所有用户均可使用创建分享时生成的临时URL和提取码，访问这个静态网站，并进行文件下载。

  临时URL是由文件夹的访问域名和临时鉴权信息组成。示例如下：

  https://e-share.obs-website.ap-southeast-1.myhuaweicloud.com:443/image.png?token=xxx

  临时鉴权的方法及各参数的详细解释，请参见《对象存储服务API参考》的URL中携带签名章节。

  直接分享

  分享者输入有效期后直接分享链接给用户。用户通过一个签名即可访问文件夹下所有的对象。

  访问文件夹内对象的临时URL是由桶域名（前缀）+对象路径+签名信息（后缀）组成。

• 永久共享：

  通过将对象权限设置为匿名用户读取权限，通过分享对象URL，匿名用户通过分享的链接地址可访问对象数据。设置权限请参见对匿名用户授予指定对象的公共读权限。

  获取对象访问URL请参见如何获取对象访问路径？

  操作失败请参见通过URL访问对象失败进行处理。

约束与限制

• 仅部分区域支持文件夹分享功能，具体支持区域请参见功能总览。
• 归档存储或深度归档存储对象需恢复后才能分享。
• 仅桶版本号为3.0的桶支持文件夹临时分享功能。查询桶版本号方法请参见OBS 2.0和OBS 3.0的判断方法。
• 临时分享文件夹的URL有效期如下：

  支持的使用方式	有效期
  控制台	取值范围为1分钟到18小时。 当对对象执行“分享”之后，OBS就会以默认5分钟的有效期获取临时鉴权信息，并生成分享链接，此时链接就已经生效并且开始计算时间了。每调整一次URL有效期，OBS就会重新获取一次鉴权信息以生成新的分享链接，新链接的有效期从调整的时候开始计算。
  API	通过参数“Expires”设置临时授权失效的时间，临时授权失效的时间为24小时。
  OBS Browser+	使用账号密码登录时，分享的有效期最长只有24小时，默认10小时。 如果需要更长的有效期，请使用永久AK/SK方式登录。
  obsutil	通过附加参数“vp”设置生成授权码的有效期，默认值为1天。该参数支持多种时间单位的配置方式，包括：m（月）、w（周）、d（天）、h（小时）、min（分钟）、s（秒）。如果不带时间单位，则该参数为授权码有效的秒数。

使用方式

OBS支持通过控制台、API、OBS Browser+、obsutil方式分享文件夹。