文档中心

GET Service


描述

此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>