Get Server

2022-09-25 15:22:14

Get Server(List Buckets)获取桶列表

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

请求语法

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

返回示例

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>