List Buckets

List Buckets

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

请求语法

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

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>

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

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>

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>