更新时间:2024-12-20 GMT+08:00
分享

分享文件夹

操作场景

您可以使用文件夹分享功能,将OBS中的整个文件夹分享给所有用户。

分享文件夹包含临时分享和永久共享。

背景知识

  • 临时分享:

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

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

    提取码分享

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

    临时URL是由文件夹的访问域名和临时鉴权信息组成。示例如下:
    https://e-share.obs-website.cn-north-4.myhuaweicloud.com:443/image.png?token=xxx

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

    直接分享

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

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

  • 永久共享:

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

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

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

约束与限制

  • 临时分享文件夹的URL有效期如下:

    支持的使用方式

    有效期

    控制台

    取值范围为1分钟到18小时。

    当对对象执行“分享”之后,OBS就会以默认5分钟的有效期获取临时鉴权信息,并生成分享链接,此时链接就已经生效并且开始计算时间了。每调整一次URL有效期,OBS就会重新获取一次鉴权信息以生成新的分享链接,新链接的有效期从调整的时候开始计算。

    如果想要设置更长的有效期,建议使用客户端工具OBS Browser+,OBS Browser+最长支持1年的有效期。如果想要设置永久的权限,请通过桶策略向匿名用户授予对象的公共读权限

    API

    通过参数“Expires”设置临时授权失效的时间,临时授权失效的时间为24小时。

    OBS Browser+

    使用账号密码登录时,分享的有效期最长只有24小时,默认10小时。

    如果需要更长的有效期,请使用永久AK/SK方式登录。

    obsutil

    通过附加参数“vp”设置生成授权码的有效期,默认值为1天。该参数支持多种时间单位的配置方式,包括:m(月)、w(周)、d(天)、h(小时)、min(分钟)、s(秒)。如果不带时间单位,则该参数为授权码有效的秒数。

  • 仅部分区域支持文件夹分享功能,具体支持区域请参见功能总览
  • 仅桶版本号为3.0的桶支持文件夹分享功能。查询桶版本号方法请参见OBS 2.0和OBS 3.0的判断方法
  • 归档存储对象需在原桶恢复后才能下载。
  • 深度归档存储对象需在原桶恢复后才能下载。

使用方式

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

相关文档