Put Bucket Acl

Put Bucket Acl

设置存储桶的访问控制列表 (ACL)。 默认情况下，只有桶的创建者才有该桶的读写权限。用户也可以设置其他的访问策略，比如对一个桶可以设置公共访问策略，允许所有人对其都有读权限。

请求语法

登录后复制PUT /?acl HTTP/1.1
Host: Bucket.s3-us-east-1.ossfiles.com

PUT /?acl HTTP/1.1 Host: Bucket.s3-us-east-1.ossfiles.com

---

URI 请求参数

名称	描述	类型
Bucket	存储桶名称	字符串
x-amz-acl	有效值： `private	public-read

x-amz-acl URL请求参数和请求消息头只能同时存在一个

---

请求消息头

名称	描述	类型
x-amz-acl	有效值： `private	public-read

x-amz-acl URL请求参数和请求消息头只能同时存在一个

---

请求正文

登录后复制PUT /?acl HTTP/1.1 
Host: bucket.s3-us-east-1.ossfiles.com
Date: date
Authorization: authorization
Content-Type: application/xml 
Content-Length: length

<AccessControlPolicy> 
    <Owner> 
        <ID>string</ID> 
        <DisplayName>string</DisplayName>
    </Owner> 
    <AccessControlList> 
        <Grant>
            <Grantee>
               <ID>string</ID>
               <DisplayName>string</DisplayName>
            </Grantee>
            <Permission>string</Permission>
        </Grant>
    </AccessControlList> 
</AccessControlPolicy>

PUT /?acl HTTP/1.1 Host: bucket.s3-us-east-1.ossfiles.com Date: date Authorization: authorization Content-Type: application/xml Content-Length: length <AccessControlPolicy> <Owner> <ID>string</ID> <DisplayName>string</DisplayName> </Owner> <AccessControlList> <Grant> <Grantee> <ID>string</ID> <DisplayName>string</DisplayName> </Grantee> <Permission>string</Permission> </Grant> </AccessControlList> </AccessControlPolicy>

---

请求元素

名称	描述	类型
Owner	所有者信息	容器
Owner.DisplayName	所有者ID	字符串
Owner.ID	所有者ID	字符串
AccessControlList	访问控制列表，包含Grant、 Grantee、Permission三个元素。	容器
AccessControlList.Grant	用于标记用户及用户的权限。单个桶的ACL，Grant元素不能超过100个。	容器
AccessControlList.Grant.Grantee	记录用户信息	容器
AccessControlList.Grant.Grantee.DisplayName	用户ID	字符串
AccessControlList.Grant.Grantee.ID	用户ID	字符串
AccessControlList.Grant.Permission	授予的权限 取值范围：private、public-read、public-read-write	字符串

一般情况下 x-amz-acl 请求头就可以满足大部分场景

---

响应语法

该请求没有响应正文。

---

响应元素

该请求没有响应元素。

---

响应消息头

该请求没有响应消息头。

---

示例

请求示例

登录后复制PUT /?acl HTTP/1.1
Authorization: AWS4-HMAC-SHA256 Credential=2421a691b4ed625de19f6f92677b6459/20230117/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-acl;x-amz-content-sha256;x-amz-date, Signature=f9a090413c9bbdf3d9fb58f3198c522ab0ab36c0629eff74903122d0eabf952e
Content-Type: application/xml
Host: bucket.s3-us-east-1.ossfiles.com
X-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
X-amz-date: 20230117T055404Z

<AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Owner>
    <ID>852b113e7a2f25102679df27bb0ae12b3f85be6</ID>
    <DisplayName>852b113e7a2f25102679df27bb0ae12b3f85be6</DisplayName>
  </Owner>
  <AccessControlList>
    <Grant>
      <Grantee>
        <ID>852b113e7a2f25102679df27bb0ae12b3f85be6</ID>
        <DisplayName>852b113e7a2f25102679df27bb0ae12b3f85be6</DisplayName>
      </Grantee>
      <Permission>public-read-write</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>

PUT /?acl HTTP/1.1 Authorization: AWS4-HMAC-SHA256 Credential=2421a691b4ed625de19f6f92677b6459/20230117/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-acl;x-amz-content-sha256;x-amz-date, Signature=f9a090413c9bbdf3d9fb58f3198c522ab0ab36c0629eff74903122d0eabf952e Content-Type: application/xml Host: bucket.s3-us-east-1.ossfiles.com X-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 X-amz-date: 20230117T055404Z <AccessControlPolicy xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Owner> <ID>852b113e7a2f25102679df27bb0ae12b3f85be6</ID> <DisplayName>852b113e7a2f25102679df27bb0ae12b3f85be6</DisplayName> </Owner> <AccessControlList> <Grant> <Grantee> <ID>852b113e7a2f25102679df27bb0ae12b3f85be6</ID> <DisplayName>852b113e7a2f25102679df27bb0ae12b3f85be6</DisplayName> </Grantee> <Permission>public-read-write</Permission> </Grant> </AccessControlList> </AccessControlPolicy>

返回示例

登录后复制HTTP/1.1 200 OK
Content-length: 0
Content-type: text/plain;charset=UTF-8
Date: Tue, 17 Jan 2023 05:54:06 GMT
x-amz-id-2: 7041fb174afd4afb93d9e62d7545b8f0
x-amz-request-id: c83e39a5426b4318a08d03ba6d80324f

HTTP/1.1 200 OK Content-length: 0 Content-type: text/plain;charset=UTF-8 Date: Tue, 17 Jan 2023 05:54:06 GMT x-amz-id-2: 7041fb174afd4afb93d9e62d7545b8f0 x-amz-request-id: c83e39a5426b4318a08d03ba6d80324f