Service相关-文档中心-金山云

对象存储(KS3)

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

对象存储(KS3)

API文档

Service相关

List Buckets（GET Service）

最近更新时间：2026-04-24 10:53:13



描述

该接口将列举目标账号下的所有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}

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

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

3. 如果没有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
VisitType	Bucket的访问类型，NORMAL为标准类型，FREQUENTLIST为高频枚举类型类型：String 父节点：ListAllMyBucketsResult.Buckets.Bucket
Type	Bucket的存储类型，NORMAL为标准类型，IA为低频类型、ARCHIVE为归档类型类型：String 父节点：ListAllMyBucketsResult.Buckets.Bucket
Region	Bucket所在区域类型：String 父节点：ListAllMyBucketsResult.Buckets.Bucket
DataRedundancyType	指定Bucket的冗余类型有效值：LRS、ZRS，LRS表示本地冗余类型，ZRS表示同城冗余类型父节点：Bucket
BucketCreatorInfo	包含Bucket创建者信息的响应信息容器。类型：Container 父节点：Bucket 2026年4月16日之前创建的桶不返回创建者相关信息，2026年4月16日及之后创建的桶会返回创建者信息。
AccessKeyId	Bucket创建者的AK信息，经过base64编码后返回。类型：String 父节点：BucketCreatorInfo 如果是通过KS3控制台创建桶，将无法获取该参数信息。
KRN	Bucket创建者的KRN信息，经过base64编码后返回。类型：String 父节点：BucketCreatorInfo 响应格式如下： 1. 主账号：krn:ksc:iam:{账号UID}:root 2. 子账号：krn:ksciam:{账号UID}:user/{子账号名称} 3. 角色：krn:ksciam:{账号UID}:role/{角色名称}
IpAddress	Bucket创建者的客户端IP。类型：String 父节点：BucketCreatorInfo 如果是通过KS3控制台创建桶，将无法获取该参数信息。

示例

简单请求示例

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>
            <VisitType>NORMAL</VisitType>
            <Type>NORMAL</Type>
            <Region>SHANGHAI</Region>
            <DataRedundancyType>LRS</DataRedundancyType>
        </Bucket>
        <Bucket>
            <Name>samples</Name>
            <CreationDate>2014-01-01T16:41:58.000Z</CreationDate>
            <VisitType>NORMAL</VisitType>
            <Type>ARCHIVE</Type>
            <Region>BEIJING</Region>
            <DataRedundancyType>LRS</DataRedundancyType>
            <BucketCreatorInfo>
                <AccessKeyId>QUtMVFozYVQ1THc3Ujl5aXVFYm1r****</AccessKeyId>
                <KRN>a3JuOmtzYzppYW06OjIwMDAxMDM0MzM6cm9v****</KRN>
                <IpAddress>10.232.17.*</IpAddress>
            </BucketCreatorInfo>
        </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>
            <VisitType>NORMAL</VisitType>
            <Region>SHANGHAI</Region>
            <DataRedundancyType>LRS</DataRedundancyType>
        </Bucket>
    </Buckets>
</ListAllMyBucketsResult>

文档导读

上一篇：Service相关

下一篇：Bucket相关

纯净模式常规模式

纯净模式

点击可全屏预览文档内容