Service相关

最近更新时间:2019-01-14 10:10:57

GET Service


描述

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

请求

语法

GET / HTTP/1.1
Host: kss.ksyun.com
Date: date
Authorization: authorization string

支持按照项目返回bucket列表,语法为:

GET  /?projectIds={projectId} HTTP/1.1
Host: kss.ksyun.com
Date: date
Authorization: authorization string

说明:

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

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

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

请求参数

该接口不使用请求参数。

请求头部

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

响应

响应内容

名称 描述
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
Type Bucket的类型,NORMAL为非归档,可以上传标准存储和低频存储;ARCHIVE为归档,只能上传归档文件
类型:String
父节点:ListAllMyBucketsResult.Buckets.Bucket
Region 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>
      <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>

金山云,开启您的云计算之旅

立即注册