GetService

GetService 接口用于获取用户在某个区域下的所有存储空间（Bucket）。如果用户在多个区域拥有存储空间，仅列出该区域下的存储空间。本操作需获得 IAM 权限 wos:GetGetService。

请求语法

GET / HTTP/1.1
Host: Bucket.Endpoint
Date: Date
Authorization: Authorization

请求参数

该请求消息中不带请求参数。

请求头

请使用公共请求头。

请求体

无请求体。

响应语法

HTTP/1.1 StatusCode
x-wos-request-id: RequestId
Date: Date
Content-Type: type
Content-Length: length
Server: WS-web-server
 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListAllMyBucketsResult xmlns="https://www.wangsu.com/document">
    <Owner>
        <ID>id</ID>
        <DisplayName>name</DisplayName>
    </Owner>
    <Buckets>
        <Bucket>
            <Name>bucketName</Name>
            <CreationDate>date</CreationDate>
        </Bucket>
        ...
    </Buckets>
</ListAllMyBucketsResult>

响应头

请使用公共响应头。

响应体

该请求的响应消息会以 XML 形式列出用户所拥有的空间（bucket）。元素的具体含义如下表所示：

示例

请求示例

GET / HTTP/1.1
Host: s3-cn-south-1.wcsapi.com
Date: Wed, 04 Nov 2020 03:09:24 GMT
Authorization: WOS-HMAC-SHA256 BF6C09F302931425E9A7:tQ+A280jUgPCAdSTuUis35T9gWI=

响应示例

HTTP/1.1 200 OK
x-wos-request-id: 9D3CC717E561E4D37A1285489689346
Content-Type: application/xml
Date: Sun, 26 Sep 2010 08:28:06 GMT
Content-Length: 485
Server: WS-web-server
 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListAllMyBucketsResult xmlns="http://wcs.chinanetcenter.com/document">
    <Owner>
        <ID>bcaf1ffd86f41caff1a493dc2ad8c2c281e37522a640e161ca5fb16fd081034f</ID>
        <DisplayName>user01</DisplayName>
    </Owner>
    <Buckets>
        <Bucket>
            <Name>bucket01</Name>
            <CreationDate>2010-09-26T03:10:23.211Z</CreationDate>
        </Bucket>
        <Bucket>
            <Name>bucket02</Name>
            <CreationDate>2010-09-20T12:05:46.187Z</CreationDate>
        </Bucket>
        <Bucket>
            <Name>bucket03</Name>
            <CreationDate>2010-09-26T08:25:13.059Z</CreationDate>
        </Bucket>
    </Buckets>
</ListAllMyBucketsResult>