Get Server(List Buckets)

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

请求语法

GET / HTTP/1.1
Authorization: authorization string
Date: GMT Date
Host: mtmss.com

响应元素(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. 如果请求中没有用户验证信息(即匿名访问),返回 403 Forbidden。错误码:AccessDenied。

示例

请求示例

GET / HTTP/1.1
Accept: */*
Accept-Encoding: gzip, deflate
Authorization: AWS 825a6cb3cbfb438b89e28fb66a944e19:oju62TPo3uFQYPt06GzQ+4UtnHA=
Connection: keep-alive
Date: Wed, 08 Nov 2017 05:26:36 GMT
Host: mtmss.com

返回示例

HTTP/1.1 200 OK
Server: Tengine
Date: Wed, 08 Nov 2017 05:48:11 GMT
Content-Type: application/xml; charset=utf-8
Content-Length: 587
Connection: keep-alive
X-Amz-Id-2: ab9f6e23723d423c026c74a02003454f
X-Amz-Request-Id: 1510120091796453
X-Ms-Trans-Id: c15c658a4d613757d0e945a3337afc5e-1510120091805965
X-Mss-Trace-Id: 310199029083140244

<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult>
    <Owner>
        <ID>mt_tenant_797157869</ID>
        <DisplayName>mt_tenant_797157869</DisplayName>
    </Owner>
    <Buckets>
        <Bucket>
            <Name>mss-s3-auth-test</Name>
            <CreationDate>2017-11-03T03:09:47.000Z</CreationDate>
        </Bucket>
        <Bucket>
            <Name>mss-s3-auth-test1</Name>
            <CreationDate>2017-10-10T07:10:49.000Z</CreationDate>
        </Bucket>
        <Bucket>
            <Name>mss-test-bucket</Name>
            <CreationDate>2017-10-09T14:25:53.000Z</CreationDate>
        </Bucket>
        <Bucket>
            <Name>mss-website</Name>
            <CreationDate>2017-09-27T09:15:02.000Z</CreationDate>
        </Bucket>
    </Buckets>
</ListAllMyBucketsResult>