分享文件夹
操作场景
您可以使用文件夹分享功能，将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支持通过控制台、API、OBS Browser+、obsutil方式分享文件夹，不支持通过SDK方式分享文件夹。
使用OBS控制台
- 在OBS管理控制台左侧导航栏选择“桶列表”。
- 在OBS管理控制台桶列表中，单击待操作的桶，进入“对象”页面。
- 选中待分享的文件夹，并单击右侧的“分享”，系统弹出“分享文件夹”对话框。
- 分享文件夹有两种方式，分别是提取码分享和直接分享。
- 方法一：提取码分享。
图1 分享文件夹
- 分享策略选择“提取码分享”。
- 设置相关参数。
表1 提取码分享文件夹参数 参数
说明
URL有效期
单位为分钟或小时，URL有效期的取值范围为1分钟到18小时，默认值为5分钟。
在“URL有效期”内，任何用户都可以访问该文件夹。
提取码
六位数字。
用户在访问分享链接时，需要输入提取码，才能看到文件夹中的对象。
- 单击“创建分享”，生成文件分享URL。
- 将链接及提取码发送给所有用户，用户通过访问链接并输入提取码以访问文件夹中的对象。
- 验证：
- 其他用户通过网页访问分享的文件夹。
- 打开网页，输入分享的URL地址，打开链接。
- 在页面提示框输入“提取码”，确认即可访问分享的文件夹。
- 其他用户通过OBS Browser+访问分享的文件夹。
- 打开OBS Browser+。
- 在登录页面选择“授权码登录”。
- 输入“授权码”和“提取码”。
- 单击“登录”，即可访问分享的文件夹。
- 方法二：直接分享。
图2 直接分享
- 分享策略选择“直接分享”。
- 设置相关参数。
表2 直接分享文件夹参数 参数
说明
URL有效期
单位为分钟或小时，URL有效期的取值范围为1分钟到18小时，默认值为5分钟。
在“URL有效期”内，任何用户都可以访问该文件夹。
- 单击“复制链接”发送给用户，用户通过该链接即可访问文件夹下所有对象。该分享链接由桶域名（前缀）+签名信息（后缀）构成，对该文件夹下所有对象生效。用户可以在分享链接的前缀后面插入对象路径来访问文件夹中的对象，支持访问下载，如图3所示。
- 验证：其他用户通过分享链接访问文件夹下所有对象。
- 打开网页，输入分享的链接（前缀+后缀）。
- 单击“Enter”键打开链接，列举出文件夹内所有对象。
- 复制对象路径，然后在前缀后黏贴。
- 单击“Enter”键打开链接，即可访问下载文件夹中的指定对象。
- 其他用户通过网页访问分享的文件夹。
