2.4.7. S3 返回存储桶对象列表


返回存储桶对象列表。

语法

GET /BUCKET?max-keys=25 HTTP/1.1
Host: cname.domain.com
Copy to Clipboard Toggle word wrap

Expand
表 2.4. 参数
名称Type描述

prefix

字符串

仅返回包含指定前缀的对象。

delimiter

字符串

前缀与其他对象名称之间的分隔符。

marker

字符串

返回的对象列表的开头索引。

max-keys

整数

要返回的最大密钥数。默认值为 1000。

Expand
表 2.5. HTTP 响应
HTTP 状态状态代码描述

200

确定

检索的存储桶

GET /BUCKET 返回存储桶的容器,并带有以下字段:

Expand
表 2.6. bucket 响应实体
名称Type描述

ListBucketResult

实体

容器,用于对象列表。

名称

字符串

其内容要返回的存储桶的名称。

prefix

字符串

对象密钥的前缀。

Marker

字符串

返回的对象列表的开头索引。

MaxKeys

整数

返回的最大键数。

Delimiter

字符串

如果设置,具有相同前缀的对象将显示在 CommonPrefixes 列表中。

IsTruncated

布尔值

如果为 true,则仅返回存储桶内容的子集。

CommonPrefixes

Container

如果多个对象包含相同的前缀,它们将显示在此列表中。

ListBucketResult 包含对象,其中每个对象都在一个 Contents 容器中。

Expand
表 2.7. 对象响应实体
名称Type描述

内容

Object

对象的容器。

字符串

对象的密钥。

LastModified

Date

对象的最后修改日期/时间。

ETag

字符串

对象的 MD-5 哈希。(标签)

大小

整数

对象的大小。

StorageClass

字符串

应始终返回 STANDARD

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat