帮助中心

快速入门 产品文档 常见问题 备案指南
选型计算器

对象存储

首页 产品文档存储对象存储文件管理 正文

对象存储产品文档之：查看对象列表

查看对象列表即列出在bucket中上传的文件（object），可以通过SpeedyCOS的接口调用一次性得到某个bukcet下最多1000个的object列表。通过下面的四个参数，可以完成多种拓展功能：

名称 描述
Delimiter 用于对Object名字进行分组的字符。所有名字包含指定的前缀且第一次出现Delimiter字符之间的Object作为一组元素: CommonPrefixes。
Marker 设定结果从Marker之后按字母排序的第一个开始返回。
MaxKeys 限定此次返回Object的最大数，如果不设定，默认为1000，MaxKeys取值小于30万。
Prefix 限定返回的Object key必须以Prefix作为前缀。注意使用prefix查询时，返回的key中仍会包含Prefix。

文件夹模拟功能

SpeedyCOS服务是没有文件夹这个概念的，所有元素都是以Object来存储。创建模拟文件夹本质上来说是创建了一个size为0的Object。对于这个Object照样可以上传下载，只是控制台会对以“.speedycloud_dir_flag”结尾的Object以文件夹的方式展示。所以您可以使用上述方式来实现创建模拟文件夹。

您可以通过 Delimiter 和 Prefix 参数的配合模拟出文件夹功能。Delimiter 和 Prefix 的组合效果是这样的：

如果把 Prefix 设为某个文件夹名，就可以罗列以此 Prefix 开头的文件，即该文件夹下递归的所有的文件和子文件夹（目录）。文件名在Contents中显示。
如果把 Delimiter 设置为 “.speedycloud_dir_flag” 时，返回值就只罗列该文件夹下的文件和子文件夹（目录），该文件夹下的子文件名（目录）返回在 CommonPrefixes 部分，子文件夹下递归的文件和文件夹不被显示。