PutBucketAcl接口用于設置或修改存儲空間(Bucket)的訪問權限(ACL)。
注意事項
使用PutBucketAcl接口時,有如下注意事項:
該接口的請求者需要對Bucket有寫入ACL的權限。
PutBucketAcl為覆蓋語義,即新傳入的ACL將覆蓋原有的ACL。
如果指定要設置ACL的Bucket不存在,調用該接口時將新建Bucket。
請求語法
PUT /?acl HTTP/1.1
x-oss-acl: Permission
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
當您在OSS ON云盒中調用該接口時,您需要將Host替換為云盒Endpoint。更多信息,請參見云盒Endpoint。
請求頭
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
x-oss-acl | 字符串 | 是 | private | 指定Bucket的訪問權限ACL。 PutBucketAcl接口通過Put請求中的x-oss-acl請求頭來設置訪問權限,如果沒有該請求頭,則訪問權限設置不生效。 取值:public-read-write、public-read、private。
|
此接口涉及的其他公共請求頭,請參見公共請求頭(Common Request Headers)。
響應頭
此接口僅涉及公共響應頭,請參見公共響應頭(Common Response Headers)。
示例
請求示例
PUT /?acl HTTP/1.1
x-oss-acl: public-read
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 24 Feb 2012 03:21:12 GMT
Authorization: OSS qn6q**************:77Dv****************
返回示例
正常返回示例
HTTP/1.1 200 OK x-oss-request-id: 534B371674E88A4D8906**** Date: Fri, 24 Feb 2012 03:21:12 GMT Content-Length: 0 Connection: keep-alive Server: AliyunOSS
設置讀寫權限無效的返回示例
HTTP/1.1 400 Bad Request x-oss-request-id: 56594298207FB3044385**** Date: Fri, 24 Feb 2012 03:55:00 GMT Content-Length: 309 Content-Type: text/xml; charset=UTF-8 Connection: keep-alive Server: AliyunOSS <?xml version="1.0" encoding="UTF-8"?> <Error> <Code>InvalidArgument</Code> <Message>no such bucket access control exists</Message> <RequestId>5***9</RequestId> <HostId>***-test.example.com</HostId> <ArgumentName>x-oss-acl</ArgumentName> <ArgumentValue>error-acl</ArgumentValue> </Error>
SDK
此接口所對應的各語言SDK如下:
錯誤碼
錯誤碼 | HTTP狀態碼 | 描述 |
AccessDenied | 403 |
|