此GET操作将返回给发出请求的验证用户一个包含其所有bucket的列表。
你需要使用KS3颁发的AccessKey来验证请求。匿名请求不会返回bucket的列表,并且你也无法得到不属于你的bucket的列表。
GET / HTTP/1.1
Host: kss.ksyun.com
Date: date
Authorization: authorization string
该接口不使用请求参数。
该接口只使用常用请求头部。获取更多信息,请点击常用请求头部。
名称 | 描述 |
---|---|
Bucket | 包含bucket信息的容器 类型:Container 子节点:Name, CreationDate 父节点:ListAllMyBucketsResult.Buckets |
Buckets | 包含一个或多个bucket的容器 类型:Container 子节点:Bucket 父节点:ListAllMyBucketsResult |
CreationDate | bucket的创建日期 类型:date(yyyy-mm-ddThh:mm:ss.timezone, e.g., 2009-02-03T16:45:09.000Z) 父节点:ListAllMyBucketsResult.Buckets.Bucket |
DisplayName | Bucket拥有者的名称 类型:String 父节点:ListAllMyBucketsResult.Owner |
ID | Bucket拥有者的用户ID 类型:String 父节点:ListAllMyBucketsResult.Owner |
ListAllMyBucketsResult | 响应信息容器 类型:Container 子节点:Owner, Buckets 父节点:无 |
Name | Bucket的名字 类型:String 父节点:ListAllMyBucketsResult.Buckets.Bucket |
Owner | 包含bucket拥有者信息的容器 类型:Container 父节点:ListAllMyBucketsResult |
该接口不返回任何特殊错误。
请求示例
GET / HTTP/1.1
Host: kss.ksyun.com
Date: Wed, 01 Jan 2014 12:00:00 GMT
Authorization: authorization string
响应示例
<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult>
<Owner>
<ID>bcaf1ffd86f461ca5fb16fd081034f</ID>
<DisplayName>webfile</DisplayName>
</Owner>
<Buckets>
<Bucket>
<Name>quotes</Name>
<CreationDate>2014-01-01T16:45:09.000Z</CreationDate>
</Bucket>
<Bucket>
<Name>samples</Name>
<CreationDate>2014-01-01T16:41:58.000Z</CreationDate>
</Bucket>
</Buckets>
</ListAllMyBucketsResult>