Service相关

最近更新时间:2023-01-11 10:41:09

查看PDF

GET Service

描述

此GET操作将返回给发出请求的验证用户一个包含其所有bucket的列表。
你需要使用KS3颁发的AccessKey来验证请求。匿名请求不会返回bucket的列表,并且你也无法得到不属于你的bucket的列表。

请求

简单请求语法

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为非归档类型,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>

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈