接口介绍

此接口用于设置对象的访问控制列表。

接口约束

请求头x-amz-acl参数和body不能同时都为空，两者必须二选一。

注：OpenAPI现在使用的是请求头x-amz-acl参数来设置对象权限。

请求URI

PUT /v1/acl/{bucket}/{objectName}

路径参数

Query参数

注： 如果query中的参数为固定参数，可以传参数名或传空。

请求参数

请求头header参数

此接口涉及的其他公共请求头，例如Host、Date等的更多信息，请参见公共HTTP头。

注意：请求头x-amz-acl参数和body不能同时都为空，两者必须二选一。

请求体Body参数

响应参数

无

请求示例

PUT /v1/acl/testbucket/test?acl

请求header

Host: gdoss.xstore.ctyun.cn
Date: Wed, 28 Oct 2023 09:32:00 GMT
Authorization: authorization string
x-amz-acl: private

请求体Body

<AccessControlPolicy>
  <Owner>
    <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
    <DisplayName>CustomersName</DisplayName>
  </Owner>
  <AccessControlList>
    <Grant>
      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">
        <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeeExampleCanonicalUserID</ID>
        <DisplayName>CustomerName</DisplayName>
      </Grantee>
      <Permission>FULL_CONTROL</Permission>
    </Grant>
  </AccessControlList>
</AccessControlPolicy>

响应示例

HTTP/1.1 200 OK
x-amz-request-id: 318BC8BC148832E5
Date: Wed, 28 Oct 2009 22:32:00 GMT

状态码