tencent cloud

文档反馈

列出对象键

最后更新时间:2024-01-06 11:00:17
    对象键(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 文档:
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持