创建ObjectSet
创建 ObjectSet
功能说明
完成 ObjectSet 初始化后,可以在百度智能云 BOS 的存储桶中创建 ObjectSet。创建时需要指定一个符合桶级规则的路径前缀,并根据业务需要设置容量和文件数量配额。
ObjectSet 创建完成后,该路径前缀将成为对象的统一命名空间入口。上传到该路径前缀下的对象,会自动归属于对应的 ObjectSet。
前置条件
- 已完成目标存储桶的 ObjectSet 初始化。
- 已确认 ObjectSet 路径前缀符合存储桶配置的层级深度和分隔符要求。
- 已规划 ObjectSet 的名称及其容量、文件数量配额。
操作步骤
1:进入 ObjectSet 管理页面
- 登录百度智能云 BOS 控制台。
- 在桶列表中选择目标存储桶。
- 在存储桶详情页左侧导航栏中,选择ObjectSet 管理。
- 单击创建 ObjectSet。

2:填写 ObjectSet 名称
ObjectSet 名称同时作为对象归属的路径前缀,需要满足以下规则:
- 长度为 3~255 个字符。
- 必须以小写字母或数字开头。
- 使用 UTF-8 编码,不支持特殊字符。
- 不允许包含
#、-、_等特殊字符。 - 使用
/分隔层级,不以/开头或结尾,且不允许连续使用/。 - 不允许出现名为
..的子目录。 - 层级数量必须与存储桶中设置的 ObjectSet 层级深度一致。
例如,存储桶的层级深度设置为 3 时,可以使用 my/project/set 作为 ObjectSet 名称;my/project 或 my/project/set/data 则不符合层级要求。

3:确认创建
确认 ObjectSet 名称和路径层级无误后,单击确定。创建成功后,新的 ObjectSet 会显示在 ObjectSet 管理列表中。

配置 ObjectSet 配额
创建完成后,在 ObjectSet 管理列表中选择目标 ObjectSet,可按需调整容量和文件数量配额。ObjectSet 可以继承全局配置,也可以单独设置。
1. 配置容量配额
在容量配额配置窗口中:
- 选择继承全局配置,使用初始化阶段定义的默认容量上限;或选择独立设置,为当前 ObjectSet 设置专属容量上限。
- 确认变更预览。
- 单击确定保存。

2. 配置文件数量配额
在文件数量配额配置窗口中:
- 选择继承全局配置,使用初始化阶段定义的默认文件数量上限;或选择独立设置,为当前 ObjectSet 设置专属文件数量上限。
- 确认变更预览。
- 单击确定保存。

使用新建的 ObjectSet
1. 上传新对象
在文件列表页面上传对象时,将上传目录设置为该 ObjectSet 对应的路径前缀。例如,ObjectSet 路径前缀为 folder1/folder2/ 时,可以将对象上传到:
1folder1/folder2/example.jpg
该对象上传成功后,即归属于对应的 ObjectSet。
2. 将已有对象纳入 ObjectSet
在文件列表页面,可以通过复制到或移动到操作,将已有对象调整到 ObjectSet 对应的路径前缀下。对象路径调整完成后,会按照新的路径重新匹配 ObjectSet 归属。
3. 查看 ObjectSet 下的对象
在文件列表页面按 ObjectSet 路径前缀筛选对象,即可查看该 ObjectSet 下的文件数据。ObjectSet 下的对象仍支持下载、删除和权限控制等对象操作。
注意事项
- 创建第一个 ObjectSet 后,存储桶的层级深度和自定义分隔符将不可修改。
- ObjectSet 名称必须严格匹配初始化时设置的层级深度。
- 不要使用
/作为 ObjectSet 名称或路径前缀。 - 创建 ObjectSet 后,存储桶中已有对象不会自动纳入该 ObjectSet;只有路径匹配或后续移动、复制到对应前缀下的对象才会归属于该 ObjectSet。
- ObjectSet 的容量和文件数量配额可继承全局配置,也可针对单个 ObjectSet 独立设置。
- 删除 ObjectSet 不等于删除对象数据。若需要清理对象,必须另行执行对象删除或批量删除操作。
- ObjectSet 容量统计存在同步延迟,不建议将页面展示的容量作为实时精确值使用。
评价此篇文章
