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
名称 | 描述 | 有效值 | 必需 |
---|---|---|---|
| 不可禁用的 ACL. |
| 否 |
HTTP 响应
如果存储桶名称是唯一的,在约束和未使用范围内,操作会成功。如果具有相同名称的存储桶已经存在,并且该用户是 bucket 所有者,则操作将成功。如果存储桶名称已经在使用中,则操作将失败。
HTTP 状态 | 状态代码 | 描述 |
---|---|---|
| BucketAlreadyExists | bucket 已存在于不同用户的所有权下。 |