该接口将列举目标账号下的所有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>
文档内容是否对您有帮助?
评价建议不能为空
非常感谢您的反馈,我们会继续努力做到更好!