列出对象键

最近更新时间:2019-07-11 17:22:40

适用场景

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

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

加入/分隔符可将根据此分隔符重新组织对象键,您可以结合前缀和分隔符来实现类似文件夹检索的功能。例如加入前缀参数t并加入分隔符/将会直接列出类似tencent/cos的对象键。

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

使用方法

使用 REST API

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

使用 SDK

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