View a markdown version of this page

ListAllMyBuckets（SOAP API） - Amazon Simple Storage Service
响应正文访问控制
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

ListAllMyBuckets（SOAP API）

注意

Amazon S3 的 SOAP API 不适用于新客户，并将于 2025 年 8 月 31 日接近使用寿命终止（EOL）。我们建议您使用 REST API 或 Amazon SDK。

ListAllMyBuckets 操作返回请求发送者所拥有的所有存储桶的列表。

例

Sample Request

<ListAllMyBuckets xmlns="https://doc.s3.amazonaws.com/2006-03-01">
  <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
  <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
  <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
</ListAllMyBuckets>

Sample Response

<ListAllMyBucketsResult xmlns="https://s3.amazonaws.com/doc/2006-03-01">
  <Owner>
    <ID>bcaf1ffd86f41161ca5fb16fd081034f</ID>
    <DisplayName>webfile</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <Name>quotes;/Name>
      <CreationDate>2006-02-03T16:45:09.000Z</CreationDate>
    </Bucket>
    <Bucket>
      <Name>samples</Name>
      <CreationDate>2006-02-03T16:41:58.000Z</CreationDate>
    </Bucket>
 </Buckets>
</ListAllMyBucketsResult>

响应正文

  • Owner:

    这提供了 Amazon S3 用于表示您的身份的信息，以用于身份验证和访问控制目的。ID 是发出请求的开发人员的唯一且永久的标识符。DisplayName 是一个便于阅读的名称，表示发出请求的开发人员。它不是唯一的，可能会随着时间推移而发生变化。我们建议您将 DisplayName 与论坛名称相匹配。

  • Name:

    存储桶的名称。请注意，如果您的某个存储桶最近被删除，则已删除存储桶的名称可能在一段时间内仍会出现在此列表中。

  • CreationDate:

    创建存储桶的时间。

访问控制

您必须使用有效的 Amazon 访问密钥 ID 进行身份验证。从不支持匿名请求列出存储桶，您只能列出您是其拥有者的存储桶。