全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

List Buckets(GET Service)

最近更新时间:2023-10-25 14:24:35

描述

该接口将列举目标账号下的所有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>
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈