You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /
  • 对象存储

ListObjects

最近更新时间：2024.01.15 15:20:41

首次发布时间：2021.10.13 16:14:08

我的收藏

功能描述

该接口用于列举桶中的对象。
要调用此接口，您需要拥有对桶的读访问权限。每次请求返回桶的部分对象（单次请求最多 1000 个），可以使用请求参数作为选择标准来返回桶中对象的子集。

请求消息样式

GET / HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: GMT Date
Authorization: authorization string

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称

位置

参数类型

是否必选

示例值

说明

delimiter

Query

String

否

/

对对象名进行分组的字符。通常使用 / 作为分组字符。

encoding-type

Query

String

否

url

指定对返回的内容进行编码的编码类型，取值说明如下：

  • url：进行 url 编码。

max-keys

Query

Integer

否

100

返回对象的最大数量。最大值为 1000，即一次请求最多返回 1000 个对象。

prefix

Query

String

否

abc

列举指定前缀的对象。

marker

Query

String

否

test.txt

列举对象的起始位置。设定从该值之后按字母排序返回对象列表。通常为上次请求返回体的 NextMarker 值。

请求元素

该请求中无请求消息元素。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

名称

参数类型

说明

Name

String

桶名。

Prefix

String

请求中带入的 prefix 参数。

Marker

String

请求中带入的 marker 参数。

MaxKeys

Integer

请求中带入的 max-keys 参数。

Delimiter

String

请求中带入的 delimiter 参数。

EncodingType

String

请求中带入的 encoding-type 参数。

IsTruncated

Bool

返回的结果是否被截断，取值说明如下：

  • false：已返回全部结果。
  • true：还有结果未返回。

NextMarker

String

如果结果未完全返回，标识下次请求的 marker 值。

CommonPrefixes

Array

请求中带 delimiter 参数时，返回的响应中包含 CommonPrefixes 分组信息。该元素标识以delimiter 结尾，并有共同前缀的对象名称的集合。

Contents

Array

对象信息的根节点。

Key

String

对象名。父节点为 Contents。

LastModified

String

对象的最后修改时间。父节点为 Contents。

ETag

String

在创建每个对象的时候生成，唯一标识一个对象的内容。父节点为 Contents。

Size

Integer

对象大小。父节点为 Contents。

StorageClass

String

对象存储类型，取值说明如下：

  • STANDARD：标准存储。
  • IA：低频访问存储。
  • INTELLIGENT_TIERING：智能分层存储。
  • ARCHIVE_FR：归档闪回存储。
  • ARCHIVE：归档存储。
  • COLD_ARCHIVE：冷归档存储。
  • DEEP_COLD_ARCHIVE：深度冷归档存储。

    说明

    深度冷归档目前处于邀测状态，如您需要使用该存储类型，请联系客户经理。

父节点为 Contents。

HashCrc64ecma

String

表示该对象的 64 位 CRC 值。该 64 位 CRC 根据 ECMA-182 标准计算得出。

说明

对 TOS 服务端支持 64 位 CRC 校验前创建的对象，则该消息头不会出现在响应消息中。

父节点为 Contents。

Owner

Object

对象所有者。父节点为 Contents。

ID

String

账号 ID。父节点为 Owner。

DisplayName

String

账号名。父节点为 Owner。

请求示例

GET / HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: Fri, 30 Jul 2021 08:05:36 GMT
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
x-tos-id-2: dc13a2093d620014-a444ed0
x-tos-request-id: dc13a2093d620014-a444ed0
Date: Fri, 30 Jul 2021 06:45:39 GMT
server: TosServer
Content-Length: 622

{
    "Name": "bucketName",
    "Prefix": "",
    "Marker": "",
    "MaxKeys": 1000,
    "IsTruncated": false,
    "Contents": [
        {
            "Key": "obj1",
            "LastModified": "2021-08-20T03:10:02.000Z",
            "ETag": "\"8a36be0d764367db4eea2deb16b71543\"",
            "Size": 109,
            "StorageClass": "STANDARD"
        },
        {
            "Key": "obj2",
            "LastModified": "2021-08-20T03:10:06.000Z",
            "ETag": "\"8a36be0d764367db4eea2deb16b71543\"",
            "Size": 109,
            "StorageClass": "STANDARD"
        },
        {
            "Key": "obj3",
            "LastModified": "2021-08-20T03:10:10.000Z",
            "ETag": "\"8a36be0d764367db4eea2deb16b71543\"",
            "Size": 109,
            "StorageClass": "STANDARD"
        }
    ]
}