对于服务地址作 Get 请求可以返回请求者拥有的所有 Bucket,其中“/”表示根目录。
GET / HTTP/1.1
Host: s3-us-east-1.ossfiles.com
该请求没有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) |
时间 |
- List Buckets 这个 API 只对验证通过的用户有效。
- 如果请求中没有用户验证信息(即匿名访问),返回 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>