757      新东方

PutBucket__关于Bucket的操作_API 参考_对象存储 OSS-阿里云

Put Bucket

PutBucket用于创建Bucket（不支持匿名访问）。创建的Bucket所在的Region和发送请求的Endpoint所对应的Region一致。Bucket所在的数据中心确定后，该Bucket下的所有Object将一直存放在对应的地区。更多内容参见 Bucket和数据中心 。

请求语法

PUT / HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
x-oss-acl: Permission
Authorization: SignatureValue

细节分析

1. 可以Put请求中的 x-oss-acl 头来设置Bucket访问权限。目前Bucket有三种访问权限：public-read-write，public-read和private。
2. 如果请求的Bucket已经存在，并且请求者是所有者，返回200 OK成功。
3. 如果请求的Bucket已经存在，但是不是请求者所拥有的，返回409 Conflict。错误码：BucketAlreadyExists。
4. 如果想创建的Bucket不符合命名规范，返回400 Bad Request消息。错误码：InvalidBucketName。
5. 如果用户发起PUT Bucket请求的时候，没有传入用户验证信息，返回403 Forbidden消息。错误码：AccessDenied。
6. 如果PutBucket的时候发现已经超过bucket最大创建数时，默认10个，返回400 Bad Request消息。错误码：TooManyBuckets。
7. 创建的Bucket，如果没有指定访问权限，则默认使用 Private 权限。

示例

请求示例：

PUT / HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 24 Feb 2012 03:15:40 GMT
x-oss-acl: private
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:77Dvh5wQgIjWjwO/KyRt8dOPfo8=

返回示例：

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906008B
Date: Fri, 24 Feb 2012 03:15:40 GMT
Location: /oss-example
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

最后更新：2016-12-12 15:01:41

  上一篇： GetService__关于Service操作_API 参考_对象存储 OSS-阿里云

  下一篇： PutBucketACL__关于Bucket的操作_API 参考_对象存储 OSS-阿里云