获取对象列表
该API 作用为列出存储桶中所有对象。
语法
GET /{bucket} HTTP/1.1
Host：cname.domain.com
参数
| 名称 | 类型 | 描述 |
|---|---|---|
| prefix | String | 仅返回具有指定前缀的对象 |
| delimiter | String | 前缀与对象名其余部分之间的分隔符 |
| marker | String | 返回对象列表的起始下标 |
| max-keys | Integer | 返回关键字的最大数目，默认为1000 |
| allow-unordered | Boolean | 允许结果无序返回，不能与delimiter 参数一起使用 |
示例
GET /{bucket}?max-keys=25 HTTP/1.1
可能的HTTP响应
| HTTP状态码 | 表示信息 | 描述 |
|---|---|---|
| 200 | OK | 存储桶已经被检索到 |
响应实体
| 名称 | 类型 | 描述 |
|---|---|---|
| ListBucketResult | Entity | 对象列表的容器 |
| Name | String | 桶名称的容器 |
| Prefix | String | 对象key 的前缀 |
| Marker | String | 返回对象的起始下标 |
| MaxKeys | Integer | Key 数目的最大值 |
| Delimiter | String | 如果该参数被设置，具有相同前缀的对象将出现在CommonPrefixes列表中 |
| IsTruncated | Boolean | 如果值为True，仅返回桶内容的一个子集 |
| CommonPrefixes | Container | 如果多个对象包含相同的前缀，它们将包含在此表中 |