2.4.8. S3 创建新存储桶

创建新存储桶。要创建存储桶，必须有用户 ID 和有效的 AWS 访问密钥 ID 才能验证请求。您不能以匿名用户身份创建存储桶。

约束

通常，存储桶名称应该遵循域名约束。

  • bucket 名称必须是唯一的。
  • bucket 名称必须以小写字母开头和结尾。
  • bucket 名称可以包含短划线(-)。

语法

PUT /BUCKET HTTP/1.1
Host: cname.domain.com
x-amz-acl: public-read-write

Authorization: AWS ACCESS_KEY:HASH_OF_HEADER_AND_SECRET

表 2.8. 参数

名称描述有效值必需

x-amz-acl

不可禁用的 ACL.

私有,public-read,public-read-write,authenticated-read

否

HTTP 响应

如果存储桶名称是唯一的，在约束和未使用范围内，操作会成功。如果具有相同名称的存储桶已经存在，并且该用户是 bucket 所有者，则操作将成功。如果存储桶名称已经在使用中，则操作将失败。

HTTP 状态状态代码描述

409

BucketAlreadyExists

bucket 已存在于不同用户的所有权下。