文档中心

对象存储

请输入

功能简介

使用须知

使用分层命名空间功能前，建议您仔细阅读本文档，避免影响功能的正常使用。

前提条件

当前支持分层命名空间功能的地域，请参见支持地域。

使用分层元数据

分层桶按照全新的分层架构来组织元数据，因此有目录实体。在支持原扁平桶的访问接口的同时，有一些访问行为上面有优化，同时如果您使用不推荐的方式访问 TOS，可能会影响性能及使用体验。建议您注意以下事项，使用推荐的方式访问分层桶。

推荐方式

不建议行为

分层桶遵循最终一致原则，在上传对象过程中，执行 Rename 各级父目录，会导致上传完成后，原文件路径（对象 Key）不可访问，需要 Rename 后的父目录重新拼接对象 Key。在分片对象未完成期间，发生父目录 Rename，也是如此。

桶类型	管理方式	实体类型	影响
分层桶	“分层”管理元数据	目录实体 + 文件实体。	单纯使用对象 Key 模拟目录层级和实际有目录层级系统的差异，如：删除目录、列举子目录和文件等，在两种桶内的行为表现不一样。
扁平桶	“扁平”管理元数据	只有对象一种实体。

约束限制

分类	约束
创建数量	每个账号最多可以创建 100 个分层桶和扁平桶。
存储桶名	存储桶名约束限制，请参见存储桶（Bucket）。
目录名称	目录与子目录或者文件之间以 / 作为分固定分隔符，列举时只能以此作为 Delimiter。
对象名称	最大支持 1024 字符长度的对象全路径，最多支持 512 层目录。
单桶规格	单桶最大支持 30 万 QPS，如需更高的 QPS，建议提前做好规划，拆分多桶来分担请求压力。单桶最多支持 5 亿个目录，如需扩展到更大目录规模，请联系技术支持申请扩展。单桶和单目录下文件数量不限。但不建议在单个目录下存放过多文件，否则可能会影响该目录的并发吞吐能力。
EMR Proton 版本	EMR Proton 2.0 及以上版本支持分层桶。如果您的 Proton 版本低于 2.0，您可以提交工单，联系火山引擎技术支持人员，更新 Proton 版本。 Proton 版本更新记录，请参见 Proton 发行版本。

最近更新时间：2026.09.03 14:40:42

这个页面对您有帮助吗？

有用

无用