此 GET 操作将指定罗列空间中的部分或全部(上限1000)的对象。
用户可以设定请求参数来选择指定空间中所要列出的对象。
用户使用此接口，需要具有对空间的 READ 权限。
注意 如果想要列举用户空间，可以使用 GET Service 接口。
GET / HTTP/1.1
Host: {BucketName}.kss.ksyun.com
Date: date
Authorization: authorization string| 参数 | 描述 | 必需 |
|---|---|---|
| delimiter | 分隔符，用于对一组参数进行分割的字符。 类型: String 默认值: 无 |
否 |
| encoding-type | 指明请求KS3与KS3响应使用的编码方式。object key 可以包含任意Unicode字符。然而，XML 1.0解析器无法解析某些字符，如ASCII码中的0到10。对于这些不能被解析的字符可以添加到请求中，KS3会在响应中对他们进行编码。类型: String 默认值: 无 有效值: url |
否 |
| marker | 指定列举指定空间中对象的起始位置。KS3按照字母排序方式返回结果，将从给定的 marker 开始返回列表。类型: String 默认值: 无 |
否 |
| max-keys | 设置响应体中返回的最大记录数（最后实际返回可能小于该值）。默认为1000。如果你想要的结果在1000条以后，你可以设定 marker 的值来调整起始位置。类型: String 默认值: 1000 |
否 |
| prefix | 限定响应结果列表使用的前缀，正如你在电脑中使用的文件夹一样。 类型: String 默认值: 无 |
否 |
该接口只使用常用请求头部。获取更多信息，请点击常用请求头部
该接口不使用请求内容。
该接口可以使用所有常用响应头部。获取更多信息，请点击常用响应头部。
| 名称 | 描述 |
|---|---|
| Contents | 每一个对象返回的元数据。 类型: XML metadata 父节点: ListBucketResult |
| CommonPrefixes | 当用户指定分隔符后，KS3会返回他们的公共前缀。实际上，公共前缀包括的值类似于文件目录中的同一个目录下的子目录。值的数量不能超过最大数量。例如：指定分隔符为 /,对于notes/summer/a.txt 和 notes/summer/b.xml，其公共前缀为 notes/summer/。类型: String 父节点: ListBucketResult |
| Delimiter | 分隔符，用于分割参数。分割后便于确定公共前缀。 类型: String 父节点: ListBucketResult |
| DisplayName | 对象的名称。 类型: String 父节点: ListBucketResult.Contents.Owner |
| Encoding-Type | KS3响应中对对象名称的编码方式。 类型: String 父节点: ListBucketResult |
| ETag | 使用对象MD5摘要的实体标签。仅取决于对象的内容。 类型: String 父节点: ListBucketResult.Contents |
| ID | 对象拥有者的用户ID。 类型: String 父节点: ListBucketResult.Contents.Owner |
| IsTruncated | 是否被截断。如果对象列表记录数超过了设定的最大值，那么将会被截断。 类型: BooleanAncestor: ListBucketResult |
| Key | 对象的 key。类型: String 父节点: ListBucketResult.Contents |
| LastModified | 最后一次被改动的时间和日期。 类型: DateAncestor: ListBucketResult.Contents |
| Marker | 指定列举指定空间中对象的起始位置。KS3按照字母排序方式返回结果，将从给定的 marker 开始返回列表。类型: String 父节点: ListBucketResult |
| MaxKeys | 响应体中返回的最大记录数。默认为1000。 类型: String 父节点: ListBucketResult |
| Name | 用户空间的名称。 类型: String 父节点: ListBucketResult |
| NextMarker | 当用户空间中对象列表记录数超过了最大值，会标记列表被截断(IsTruncated=true)，同时返回下个记录的位置信息。用户在下次list objects的时候，可以使用该值作为marker参数。注意：当不提供delimiter参数的时候，KS3将不会返回NextMarker,如果IsTruncated为true，则可以使用返回的Contents中的最后一个key作为下次list的marker参数类型: String 父节点: ListBucketResult |
| Owner | 用户空间拥有者信息。 类型: String 子节点: DisplayName, ID : ListBucketResult.Contents &##124; CommonPrefixes |
| Prefix | 该list请求时指定的key前缀类型: String 父节点: ListBucketResult |
| Size | 对象的大小，按字节统计。 类型: String 父节点: ListBucketResult.Contents |
| StorageClass | 存储方式，包括： STANDARD 类型: String 父节点: ListBucketResult.Contents |
该接口不返回任何特殊错误。
请求示例
GET / HTTP/1.1
Host: BucketName.kss.ksyun.com
Date: Wed, 12 Oct 2009 17:50:00 GMT
Authorization: authorization string
Content-Type: text/plain响应示例
<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Name>bucket</Name>
<Prefix/>
<Marker/>
<MaxKeys>1000</MaxKeys>
<IsTruncated>false</IsTruncated>
<Contents>
<Key>my-image.jpg</Key>
<LastModified>2009-10-12T17:50:30.000Z</LastModified>
<ETag>"fba9dede5f27731c9771645a39863328"</ETag>
<Size>434234</Size>
<StorageClass>STANDARD</StorageClass>
<Owner>
<ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
<DisplayName>mtd@kingsoft.com</DisplayName>
</Owner>
</Contents>
<Contents>
<Key>my-third-image.jpg</Key>
<LastModified>2009-10-12T17:50:30.000Z</LastModified>
<ETag>"1b2cf535f27731c974343645a3985328"</ETag>
<Size>64994</Size>
<StorageClass>STANDARD</StorageClass>
<Owner>
<ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
<DisplayName>mtd@kingsoft.com</DisplayName>
</Owner>
</Contents>
</ListBucketResult>IsTruncated为true时，表示返回的结果被截断，也就是说这这次list还没有把所有的object都list出来，若请求参数中包含delimiter，则可以使用返回的NextMarker做为下次list的marker参数，若请求参数中不包含delimiter,则可以使用返回的Contents中的最后一个做为下次list的marker参数。