控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

列出对象键

最近更新时间:2021-03-17 12:31:50

对象键(ObjectKey) 是对象在存储桶中的唯一标识,可以通俗的理解为文件路径。例如对象键为 doc/picture.jpg 则表示为图片文件 picture.jpg 存放在对象存储(Cloud Object Storage,COS)的 doc 路径(或文件夹)下。

列出对象键即按照指定的对象键查找特定对象。此外,也可以按对象键前缀查找对象,即指定对象键前面的一部分(例如 doc)查找具有相同前缀 doc 的所有对象。

适用场景

腾讯云 COS 支持按照前缀顺序列出对象键,您也可以在对象键中使用/字符来实现类似传统文件系统的层级结构,COS 也支持按照分隔符来做层级结构的选择和浏览。

您可以列出单个存储桶中的所有对象键,根据前缀的 UTF-8 二进制顺序列出,或选择指定前缀过滤对象键的列表。例如加入参数t将列出tencent的对象,而跳过以a或其他字符为前缀的对象。

加入/分隔符可将根据此分隔符重新组织对象键,您可以结合前缀和分隔符来实现类似文件夹检索的功能。

腾讯云 COS 在单个存储桶中支持无限数量的对象,因此对象键列表可能非常大。为了管理方便,单个列出对象接口将最多返回1000个对象列表,同时会返回指示器来告知是否存在截断,若存在截断,则表示下一页还存在对象列表。您可以根据指示器和分隔符多次发起列出对象键请求,实现列出所有对象键,或查询您所需要的内容。

使用方法

使用对象存储控制台

您可以使用控制台搜索对象,详情请参见 搜索对象 控制台指南文档。

使用 REST API

您可以直接使用 REST API 发起列出对象键请求,详情请参见 GET Bucket(List Objects) API 文档。

使用 SDK

您可以直接调用 SDK 的查询对象列表方法,详情请参见下列各语言 SDK 文档: