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 进行身份验证。从不支持匿名请求创建存储桶。