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-阿裏雲