CreateBucket (SOAP API)

注意

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

CreateBucket 操作會建立儲存貯體。不是每個字串都是可接受的儲存貯體名稱。如需儲存貯體命名限制的資訊，請參閱使用 Amazon S3 儲存貯體。

注意

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

範例建立名為「引號」的儲存貯體

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 進行身分驗證。不允許匿名請求建立儲存貯體。

相關資源

• ListBucket (SOAP API)