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 SDKs。

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

注意

若要判斷儲存貯體名稱是否存在,請使用 ListBucketMaxKeys設為 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 進行身分驗證。不允許匿名請求建立儲存貯體。

相關資源