功能支持说明
更新时间:2024-08-15
功能支持与限制
支持
- 支持文件、目录语义和操作
- 目录原子性、毫秒级 Rename
- 优化读性能
- 支持平层对象存储绝大部分功能
限制
开启分层命名空间的存储桶支持功能与平层命名空间存储桶基本相同,均支持对象级别操作基本均支持比如:上传、下载、复制等;存储桶级别的配置功能如生命周期、事件通知、日志管理等也可正常使用,目前相比起平层命名空间存储桶仅有少部分功能暂不支持,若您有需求可提交工单反馈,具体说明如下:
Bucket 相关功能
- 不支持回收站
Object 相关功能
- 不支持归档存储类型文件
- 不支持上传带内容的目录(即上传内容非空但文件名末尾是
/
的文件) - 不支持文件软链接功能
- 不支持对象标签
接口调整
由于分层命名空间特性导致部分 BOS API 会有部分兼容和语义上的调整,如下所示:
ListObjects
对于 平层命名空间存储桶,分层命名空间下的 ListObjects API 的请求参数有所调整,具体说明参见下表,平层命名空间 ListObjects 详情请查看ListObjects接口说明。
字段 | 类型 | 是否必需 | 描述 |
---|---|---|---|
delimiter | String | 否 | 分隔符; 分层 Namespace 下 ListObjects 必须指定,且只能为/ |
marker | String | 否 | Object 为字母序排列,从 Marker 之后的第一个开始返回,为对象(文件)的全路径;分层命名空间下,将会返回父目录下的子文件或者子目录按照字典序大于 Marker 的结果 |
maxKeys | Int | 否 | 返回 Object 列表长度最大为 1000,默认值是 1000,如果指定的值大于 1000,按 1000 操作 |
prefix | String | 否 | 必须为对象的父目录,限定 ListObjects 接口只能返回以 Prefix 为父目录下的对象;Prefix 可以不以/ 结尾,BOS 会默认为其自动添加目录分隔符 |
特别说明
ListObjects 会将父目录下的所有子目录与对象按照字典序排序后返回;
ListObjects 在分层空间存储桶的目录下不再支持列出某个前缀(目录)下的所有文件,只支持根据给出的父目录信息列出子目录和子文件。