本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# CreateBucket (SOAP API)
<a name="SOAPCreateBucket"></a>

**注意**  
 Amazon S3 的 SOAP API 不適用於新客戶，並且將於 2025 年 8 月 31 日接近生命週期結束 (EOL)。我們建議您使用 REST API 或 AWS SDKs。

`CreateBucket` 操作會建立儲存貯體。不是每個字串都是可接受的儲存貯體名稱。如需儲存貯體命名限制的資訊，請參閱[使用 Amazon S3 儲存貯體](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingBucket.html)。

**注意**  
 若要判斷儲存貯體名稱是否存在，請使用 `ListBucket`並`MaxKeys`設為 0。NoSuchBucket 回應表示儲存貯體可用，AccessDenied 回應表示其他人擁有儲存貯體，而 Success 回應表示您擁有儲存貯體或具有存取儲存貯體的許可。

**Example 建立名為「引號」的儲存貯體**  
`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)