# CreateBucket（SOAP API）
<a name="SOAPCreateBucket"></a>

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

`CreateBucket` 操作创建一个存储桶。并非每个字符串都是可接受的存储桶名称。有关存储桶命名限制的信息，请参阅[使用 Amazon S3 存储桶](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingBucket.html)。

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

**Example 创建一个名为“quotes”的存储桶**  
`Sample Request`  

```
1. <CreateBucket xmlns="https://doc.s3.amazonaws.com/2006-03-01">
2.   <Bucket>quotes</Bucket>
3.   <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
4.   <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
5.   <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
6. </CreateBucket>
```
`Sample Response`  

```
1. <CreateBucketResponse xmlns="https://s3.amazonaws.com/doc/2006-03-01">
2.   <CreateBucketResponse>
3.     <Bucket>quotes</Bucket>
4.   </CreateBucketResponse>
5. </CreateBucketResponse>
```

## 元素
<a name="SOAPCreateBucketElements"></a>
+ `Bucket:` 您尝试创建的存储桶的名称。

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

  

## 访问控制
<a name="SOAPCreateBucketAccessControl"></a>

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

## 相关资源
<a name="SOAPCreateBucket_RelatedResources"></a>
+  [ListBucket（SOAP API）](SOAPListBucket.md)