List Buckets

2023-02-19 18:20:00

List Buckets

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

请求语法

GET / HTTP/1.1
Host: s3-us-east-1.ossfiles.com

URI 请求参数

该请求没有URI请求参数。


请求消息头

该请求没有请求消息头。


请求正文

该请求没有请求正文。


请求元素

该请求没有请求元素。


响应语法

HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult>
   <Buckets>
      <Bucket>
         <CreationDate>timestamp</CreationDate>
         <Name>string</Name>
      </Bucket>
   </Buckets>
   <Owner>
      <DisplayName>string</DisplayName>
      <ID>string</ID>
   </Owner>
</ListAllMyBucketsResult>

响应元素

名称 描述 类型
Owner 所有者信息 容器
Owner.DisplayName 所有者ID 字符串
Owner.ID 所有者ID 字符串
Buckets 存储桶列表 容器
Buckets.Bucket 桶信息 容器
Buckets.Bucket.Name 桶名称 字符串
Buckets.Bucket.CreationDate 创建时间 (格式:
yyyy-mm-ddThh:mm:ss.timezone,
e.g.,2017-11-03T03:09:47.000Z)
时间
  1. List Buckets 这个 API 只对验证通过的用户有效。
  2. 如果请求中没有用户验证信息(即匿名访问),返回 403 Forbidden。错误码:AccessDenied。

响应消息头

该请求没有响应消息头。


示例

请求示例

GET / HTTP/1.1
Authorization: AWS4-HMAC-SHA256 Credential=2421a691b4ed625de19f6f92677b6459/20230116/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=42505d1748adbebfedc8004101aa7093dfcd996cd4c44fc36b798417d7351fd2
Content-length: 0
Host: s3-us-east-1.ossfiles.com
X-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
X-amz-date: 20230116T172524Z

返回示例

HTTP/1.1 200 OK
Content-type: application/xml
Date: Mon, 16 Jan 2023 17:25:25 GMT
x-amz-id-2: a6e56668caf24763945276e4bb88e76c
x-amz-request-id: 8af834bebf57487c9219fa18e636a73c

<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Owner>
        <ID>c2287ffd54231d96dfdfe69e798965ca</ID>
        <DisplayName>c2287ffd54231d96dfdfe69e798965ca</DisplayName>
    </Owner>
    <Buckets>
        <Bucket>
            <Name>testBucket</Name>
            <CreationDate>2022-09-06 17:25:53</CreationDate>
        </Bucket>
        <Bucket>
            <Name>testBucket1</Name>
            <CreationDate>2022-05-29 01:49:49</CreationDate>
        </Bucket>
        <Bucket>
            <Name>testBucket2</Name>
            <CreationDate>2022-09-08 18:59:31</CreationDate>
        </Bucket>
    </Buckets>
</ListAllMyBucketsResult>