Get Server

Get Server（List Buckets）获取桶列表

对于服务地址作 Get 请求可以返回请求者拥有的所有 Bucket，其中“/”表示根目录。

请求语法

登录后复制GET / HTTP/1.1
Host: s3-us-east-1.ossfiles.com
Date: GMT Date
Authorization: SignatureValue

GET / HTTP/1.1 Host: s3-us-east-1.ossfiles.com Date: GMT Date Authorization: SignatureValue

响应元素（Response Elements）

名称	描述
ListAllMyBucketsResult	保存 Get Service 请求结果的容器。 类型：容器 子节点: Owner, Buckets 父节点：None
Owner	用于存放 Bucket 拥有者信息的容器。 类型：容器 父节点：ListAllMyBucketsResult
ID	Bucket 拥有者的用户 ID。 类型：字符串 父节点：ListAllMyBucketsResult.Owner
DisplayName	Bucket 拥有者的名称 (目前和 ID 一致)。 类型：字符串 父节点：ListAllMyBucketsResult.Owner
Buckets	保存多个 Bucket 信息的容器。 类型：容器 子节点：Bucket 父节点：ListAllMyBucketsResult
Bucket	保存 Bucket 信息的容器。 类型：容器 子节点：Name, CreationDate 父节点：ListAllMyBucketsResult.Buckets
Name	Bucket 名称。 类型：字符串 父节点：ListAllMyBucketsResult.Buckets.Bucket
CreationDate	Bucket 创建时间。 类型：时间 (格式：yyyy-mm-ddThh:mm:ss.timezone, e.g.,2017-11-03T03:09:47.000Z) 父节点：ListAllMyBucketsResult.Buckets.Bucket

细节分析

1. GetService 这个 API 只对验证通过的用户有效。
2. 如果请求中没有用户验证信息（即匿名访问），返回错误。

示例

请求示例

登录后复制GET / HTTP/1.1
Authorization: AWS4-HMAC-SHA256 Credential=6a19c6de088ff32ff663287eec8f3b85/20220421/us-east-1/s3/aws4_request,SignedHeaders=host;user-agent;x-amz-content-sha256;x-amz-date, Signature=0d55a19067ae818ddf24b590ffcba0a5aecb6c5bd9e633938a1753562af4c7d2
x-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
x-amz-date: 20220421T183624Z
Host: s3-us-east-1.ossfiles.com

GET / HTTP/1.1 Authorization: AWS4-HMAC-SHA256 Credential=6a19c6de088ff32ff663287eec8f3b85/20220421/us-east-1/s3/aws4_request,SignedHeaders=host;user-agent;x-amz-content-sha256;x-amz-date, Signature=0d55a19067ae818ddf24b590ffcba0a5aecb6c5bd9e633938a1753562af4c7d2 x-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 x-amz-date: 20220421T183624Z Host: s3-us-east-1.ossfiles.com

返回示例

登录后复制HTTP/1.1 200 OK
Date: Thu, 21 Apr 2022 18:36:19 GMT
Content-Type: application/xml
Content-Length: 462
Connection: keep-alive
Expires: Sat, 03 Mar 1990 23:33:33 GMT

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ListAllMyBucketsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Owner>
        <ID>e88258513ab40fc3564b8bb6b5441bdd</ID>
        <DisplayName>e88258513ab40fc3564b8bb6b5441bdd</DisplayName>
    </Owner>
    <Buckets>
        <Bucket>
            <Name>test213132</Name>
            <CreationDate>2022-04-18 18:24:49</CreationDate>
        </Bucket>
        <Bucket>
            <Name>test212</Name>
            <CreationDate>2022-04-14 23:48:49</CreationDate>
        </Bucket>
    </Buckets>
</ListAllMyBucketsResult>

HTTP/1.1 200 OK Date: Thu, 21 Apr 2022 18:36:19 GMT Content-Type: application/xml Content-Length: 462 Connection: keep-alive Expires: Sat, 03 Mar 1990 23:33:33 GMT <?xml version="1.0" encoding="utf-8" standalone="yes"?> <ListAllMyBucketsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Owner> <ID>e88258513ab40fc3564b8bb6b5441bdd</ID> <DisplayName>e88258513ab40fc3564b8bb6b5441bdd</DisplayName> </Owner> <Buckets> <Bucket> <Name>test213132</Name> <CreationDate>2022-04-18 18:24:49</CreationDate> </Bucket> <Bucket> <Name>test212</Name> <CreationDate>2022-04-14 23:48:49</CreationDate> </Bucket> </Buckets> </ListAllMyBucketsResult>