GetService

最終更新日:2025-08-22 15:16:41

GetServiceインターフェースは、ユーザーがエリア内で所有しているすべてのバケットを取得するために使用されます。ユーザーが複数のエリアにバケットを持っている場合でも、そのエリアに属するバケットのみが一覧表示されます。この操作にはIAM権限wos:GetGetServiceが必要です。

リクエスト構文

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

リクエストパラメータ

リクエストメッセージにパラメータはありません。

リクエストヘッダー

common request headers をご利用ください。

リクエストボディ

リクエストボディはありません。

レスポンス構文

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>

レスポンスヘッダー

common response headers をご利用ください。

レスポンスボディ

このリクエストのレスポンスメッセージには、ユーザーが所有するバケットがXML形式で一覧表示されます。各要素の具体的な意味は以下の表の通りです。

Element NameDescription
ListAllMyBucketsResultユーザーのバケットリスト。

型: XML
Ownerユーザー情報(ユーザーID、ユーザー名を含む)。

型: XML
IDユーザーのDomainId。

型: string
DisplayNameユーザー名。

型: string
Bucketsユーザーが所有するバケットのリスト。

型: XML
Bucket各バケットの詳細情報。

型: XML
Nameバケット名。

型: string
CreationDateバケットの作成日時。

型: string

リクエスト例

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>