分享文件夹
操作场景
您可以使用文件夹分享功能,将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方式分享文件夹。