分享文件夹-九游平台
操作场景
您可以使用文件夹分享功能,将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方式分享文件夹。
相关文档
意见反馈
文档内容是否对您有帮助?
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨