2.4.7. S3 返回存储桶对象列表
返回存储桶对象列表。
语法
GET /BUCKET?max-keys=25 HTTP/1.1 Host: cname.domain.com
GET /BUCKET?max-keys=25 HTTP/1.1
Host: cname.domain.com
名称 | Type | 描述 |
---|---|---|
| 字符串 | 仅返回包含指定前缀的对象。 |
| 字符串 | 前缀与其他对象名称之间的分隔符。 |
| 字符串 | 返回的对象列表的开头索引。 |
| 整数 | 要返回的最大密钥数。默认值为 1000。 |
HTTP 状态 | 状态代码 | 描述 |
---|---|---|
| 确定 | 检索的存储桶 |
GET /BUCKET
返回存储桶的容器,并带有以下字段:
名称 | Type | 描述 |
---|---|---|
| 实体 | 容器,用于对象列表。 |
| 字符串 | 其内容要返回的存储桶的名称。 |
| 字符串 | 对象密钥的前缀。 |
| 字符串 | 返回的对象列表的开头索引。 |
| 整数 | 返回的最大键数。 |
| 字符串 |
如果设置,具有相同前缀的对象将显示在 |
| 布尔值 |
如果为 |
| Container | 如果多个对象包含相同的前缀,它们将显示在此列表中。 |
ListBucketResult
包含对象,其中每个对象都在一个 Contents
容器中。
名称 | Type | 描述 |
---|---|---|
| Object | 对象的容器。 |
| 字符串 | 对象的密钥。 |
| Date | 对象的最后修改日期/时间。 |
| 字符串 | 对象的 MD-5 哈希。(标签) |
| 整数 | 对象的大小。 |
| 字符串 |
应始终返回 |