put-bucket-acl
Put Bucket Acl
1. 描述
为已创建的bucket设置Acl，用户需要是bucket所属者或者拥有bucket WRITE_ACP权限该接口可设置Bucket的访问权限有public-read和private，通常通过“x-awz-acl”参数来设置。
2. 请求地址
PUT /{bucket}?acl
3. 请求头
该请求头公共信息请参考【公共参数】部分。
| Name | Type | Description | Required |
|---|---|---|---|
| x-amz-acl | String | 定义Bucket访问权限，有效值：private和public-read | 否 |
4. 请求参数
无
5. 请求示例
PUT /bucket123?acl HTTP/1.1
Host: cn-east-1.cloud-oss.com
Date: Thu, 15 Nov 2018 13:27:48 GMT
Nonce: 5e72e157-f4e3-4180-9062-7c7127939faa
Authorization: YCS1-HMAC-SHA1 Credential=5adb2538-9333-4024-b757-e095fc609a84, SignedHeaders=date;nonce;version, Signature=5KmNSmZ7/vlWNti0cgNpJFiQNMY=
x-amz-acl: public-read
Version: 2018-10-30
6. 返回示例
{
"id" : "61281cdb-9fd1-4fc3-b443-ee547de9c8e7",
"name" : "bucket123",
"owner" : "2c94808965a74de00165a94b16cf0033",
"projectId" : "2c9481226684eb130166854b595e0035",
"created" : 1542288407586,
"storeBytes" : 0,
"fileCount" : 0,
"cannedAcl" : "public-read"
}
7. 错误码
该接口没有特殊错误码，错误码可以参考公共错误码