List Buckets（GET Service）

描述

该接口将列举目标账号下的所有Bucket，您还可以通过设置projectIds参数列举指定项目组内的所有Bucket。使用此接口，您需要具有ks3:ListBuckets权限。

请求语法

简单请求语法

GET / HTTP/1.1
Host: {endpoint}
Date: {date}
Authorization: {SignatureValue}

指定项目组时请求语法

GET /?projectIds={projectId} HTTP/1.1
Host: {endpoint}
Date: {date}
Authorization: {SignatureValue}

说明：

• 如果需要返回项目ID为2345的项目下的Bucket列表，请求为/?projectIds=2345。

• 如需返回多个项目下的Bucket列表，例如需返回项目ID为1234、3456、3344下所有的Bucket列表，多个项目ID需以英文半角逗号分隔，请求为/?projectIds=1234,3456,3344。

• 如果没有projectIds参数，或者projectIds参数为空，将返回所有项目下的Bucket列表。

请求参数

该接口不使用请求参数。

请求头部

该接口只使用常用请求头部。获取更多信息，请点击常用请求头部。

响应

响应内容

名称	描述
ListAllMyBucketsResult	响应信息容器 类型：Container 子节点：Owner, Buckets 父节点：无
Owner	包含bucket拥有者信息的容器 类型：Container 父节点：ListAllMyBucketsResult
ID	Bucket拥有者的用户ID 类型：String 父节点：ListAllMyBucketsResult.Owner
DisplayName	Bucket拥有者的名称 类型：String 父节点：ListAllMyBucketsResult.Owner
Buckets	包含一个或多个bucket的容器 类型：Container 子节点：Bucket 父节点：ListAllMyBucketsResult
Bucket	包含bucket信息的容器 类型：Container 子节点：Name, CreationDate,Type,Region 父节点：ListAllMyBucketsResult.Buckets
Name	Bucket的名字 类型：String 父节点：ListAllMyBucketsResult.Buckets.Bucket
CreationDate	bucket的创建日期 类型：date(yyyy-mm-ddThh:mm:ss.timezone, e.g., 2009-02-03T16:45:09.000Z) 父节点：ListAllMyBucketsResult.Buckets.Bucket
Type	Bucket的类型，NORMAL为标准类型，IA为低频类型、ARCHIVE为归档类型 类型：String 父节点：ListAllMyBucketsResult.Buckets.Bucket
Region	Bucket所在区域 类型：String 父节点：ListAllMyBucketsResult.Buckets.Bucket

特殊错误

该接口不返回任何特殊错误。

示例

简单请求示例

GET / HTTP/1.1
Host: ks3-cn-beijing.ksyuncs.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>
      <Type>NORMAL</Type>
      <Region>SHANGHAI</Region> 
    </Bucket>
    <Bucket>
      <Name>samples</Name>
      <CreationDate>2014-01-01T16:41:58.000Z</CreationDate>
      <Type>ARCHIVE</Type>
      <Region>BEIJING</Region> 
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

指定项目组时请求示例

GET /?projectIds=0 HTTP/1.1
Host: ks3-cn-beijing.ksyuncs.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>
            <Type>NORMAL</Type>
            <Region>SHANGHAI</Region>
        </Bucket>
    </Buckets>
</ListAllMyBucketsResult>