帮你快速理解、总结文档立即下载
文档中心>对象存储>高性能存储>API 文档>存储桶操作>GetService

GetService

最近更新时间：2026-10-21 18:34:04
我的收藏

本页目录：

GetService 接口请求等同于 ListBuckets，可以列出调用方主账号下的全部存储桶。

注意事项

分页

当 IsTruncated 为 true 时，将响应中的 NextMarker 原样作为下次请求的 marker 传入，直到 IsTruncated 为 false。

请求

请求语法

GET /?max-keys=<MaxKeys>&marker=<Marker> HTTP/1.1
Host: service.cosrapid.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明：
Authorization 字段的具体格式见 公共请求头部。
Host 固定为 service.cosrapid.<Region>.myqcloud.com，不带存储桶名前缀；<Region> 指定本次要列举的存储桶所在地域，本接口仅返回该 Region 下的存储桶；如需查看其他 Region 下的存储桶，请分别调用。

请求参数

参数名称
描述
类型
是否必选
max-keys
单次返回的最大存储桶数量，取值范围 1~2000，默认值 2000
integer
否
marker
分页游标，取值为上一次 GetService 响应中的 NextMarker；首次请求无需携带
string
否

请求头部

此接口仅使用公共请求头部，无私有请求头部。

请求体

该请求的请求体为空。

响应

响应头部

仅返回公共响应头部，本接口无私有响应头部。

响应体

请求成功，返回 application/xml 数据：
<ListAllMyBucketsResult>
    <Owner>
        <ID>qcs::cam::uin/<OwnerUin>:uin/<OwnerUin></ID>
        <DisplayName><OwnerUin></DisplayName>
    </Owner>
    <Marker>string</Marker>
    <NextMarker>string</NextMarker>
    <IsTruncated>true|false</IsTruncated>
    <Buckets>
        <Bucket>
            <Name>string</Name>
            <Location>string</Location>
            <CreationDate>date</CreationDate>
            <VpcId>string</VpcId>
            <SubnetId>string</SubnetId>
            <Zone>string</Zone>
            <Status>string</Status>
        </Bucket>
        ...
    </Buckets>
</ListAllMyBucketsResult>
字段说明：
节点名称
父节点
描述
类型
ListAllMyBucketsResult
无
响应根节点，包含 GetService 的全部结果
Container
Owner
ListAllMyBucketsResult
存储桶持有者信息
Container
Marker
ListAllMyBucketsResult
本次请求所使用的分页游标，回显请求参数 marker；未指定时为空
string
NextMarker
ListAllMyBucketsResult
下一页的分页游标，仅当 IsTruncated 为 true 时返回非空
string
IsTruncated
ListAllMyBucketsResult
是否仍有未列举完的存储桶：true 表示存在下一页，false 表示已全部列举完毕
boolean
Buckets
ListAllMyBucketsResult
存储桶列表容器
Container
Owner 节点：
节点名称
父节点
描述
类型
ID
Owner
存储桶持有者完整 ID，格式为 qcs::cam::uin/<OwnerUin>:uin/<OwnerUin>
string
DisplayName
Owner
存储桶持有者主账号 UIN
string
Buckets.Bucket 节点：
节点名称
父节点
描述
类型
Name
Buckets.Bucket
存储桶完整名称，格式为 <BucketName>-x--<APPID>，例如 examplebucket-x--1250000000
string
Location
Buckets.Bucket
存储桶所在地域，例如 ap-guangzhou
string
CreationDate
Buckets.Bucket
存储桶的创建时间，ISO 8601 格式（RFC3339），例如 2023-10-13T09:13:10Z
date
VpcId
Buckets.Bucket
存储桶绑定的 VPC ID，回显创建该桶时通过 x-cos-vpc-id 传入的值
string
SubnetId
Buckets.Bucket
存储桶绑定的子网 ID，回显创建该桶时通过 x-cos-subnet-id 传入的值
string
Zone
Buckets.Bucket
存储桶所在可用区，回显创建该桶时通过 x-cos-zone 传入的值，例如 ap-guangzhou-3
string
Status
Buckets.Bucket
存储桶状态（Creating：创建中；Available：正常；Deleting：删除中）
string

错误码

本接口遵循统一的错误响应和错误码，详情请参见 错误码 文档。

实际案例

请求

GET / HTTP/1.1
Host: service.cosrapid.ap-guangzhou.myqcloud.com
Date: Fri, 13 Oct 2023 09:13:10 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKIDXXXXXXXX&q-sign-time=1484813288;32557709288&q-key-time=1484813288;32557709288&q-header-list=date;host&q-url-param-list=&q-signature=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Fri, 13 Oct 2023 09:13:10 GMT
x-cos-request-id: NjUwMDAwMDAwMDAwMDAwMDAw

<ListAllMyBucketsResult>
    <Owner>
        <ID>qcs::cam::uin/100000000001:uin/100000000001</ID>
        <DisplayName>100000000001</DisplayName>
    </Owner>
    <Marker></Marker>
    <NextMarker></NextMarker>
    <IsTruncated>false</IsTruncated>
    <Buckets>
        <Bucket>
<Name>examplebucket1-x--1250000000</Name>
            <Location>ap-guangzhou</Location>
            <CreationDate>2023-10-12T11:49:50Z</CreationDate>
            <VpcId>vpc-abcdefgh</VpcId>
            <SubnetId>subnet-abcdefgh</SubnetId>
            <Zone>ap-guangzhou-3</Zone>
            <Status>Available</Status>
        </Bucket>
        <Bucket>
<Name>examplebucket2-x--1250000000</Name>
            <Location>ap-guangzhou</Location>
            <CreationDate>2023-10-13T09:13:10Z</CreationDate>
            <VpcId>vpc-ijklmnop</VpcId>
            <SubnetId>subnet-ijklmnop</SubnetId>
            <Zone>ap-guangzhou-4</Zone>
            <Status>Creating</Status>
        </Bucket>
    </Buckets>
</ListAllMyBucketsResult>

中国站