View a markdown version of this page

CreateBucket（SOAP API） - Amazon Simple Storage Service
元素访问控制相关资源

CreateBucket（SOAP API）

注意

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

CreateBucket 操作创建一个存储桶。并非每个字符串都是可接受的存储桶名称。有关存储桶命名限制的信息，请参阅使用 Amazon S3 存储桶。

注意

要确定存储桶名称是否存在，请使用 ListBucket 并将 MaxKeys 设置为 0。NoSuchBucket 响应表示该存储桶可用，AccessDenied 响应表示其他人拥有该存储桶，Success 响应表示您拥有该存储桶或有权访问该存储桶。

例创建一个名为“quotes”的存储桶

Sample Request

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

Sample Response

<CreateBucketResponse xmlns="https://s3.amazonaws.com/doc/2006-03-01">
  <CreateBucketResponse>
    <Bucket>quotes</Bucket>
  </CreateBucketResponse>
</CreateBucketResponse>

元素

  • Bucket: 您尝试创建的存储桶的名称。

  • AccessControlList: 新存储桶的访问控制列表。此元素是可选的。如果未提供，则使用向请求者授予 FULL_CONTROL 访问权限的访问策略创建存储桶。

访问控制

您必须使用有效的 AWS 访问密钥 ID 进行身份验证。从不支持匿名请求创建存储桶。

相关资源