文档中心 > PutObjectACL
PutObjectACL

最近更新时间:2022-01-18

使用PutObjectACL接口设置Bucket中的存在的Object的ACL权限。

请求

请求语法

PUT /ObjectName?acl HTTP/1.1

Host: examplebucket.region.unicloudsrv.com

Date: date

Authorization: authorization string

 

<AccessControlPolicy>

  <Owner>

    <ID>ID</ID>

    <DisplayName>EmailAddress</DisplayName>

  </Owner>

  <AccessControlList>

    <Grant>

      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">

<ID>ID</ID>

<DisplayName>EmailAddress</DisplayName>

      </Grantee>

      <Permission>Permission</Permission>

    </Grant>

    ...

  </AccessControlList>

</AccessControlPolicy>

请求消息头

参数

描述

x-amz-acl

用于对象的预定义权限,有效值:private,public-read,public-read-write。

x-amz-grant-read

受让人可以查询bucket中Object。

x-amz-grant-write

受让人可以创建、覆盖、删除bucket中Object。

x-amz-grant-read-acp

允许为适当的bucket写ACL。

x-amz-grant-full-control

受让人可以读、写、读ACL、写ACL bucket中权限。

请求元素

参数

描述

AccessControlList

包含 Grant,Grantee,Permission 的容器。

AccessControlPolicy

包含了每一个 Grantee 对于某个对象的 ACL 权限设置信息。

Grant

包含被授权者和其权限信息。

Grantee

被授权者。

DisplayName

Bucket拥有者的名称。

ID

Bucket拥有者的用户ID。

Owner

包含bucket拥有者信息(DisplayName,ID)的容器。

Permission

指明授予被授权者的权限信息。

示例

请求示例

PUT /my-image.jpg?acl HTTP/1.1

Host: test.oss-cn-north-1.unicloudsrv.com

Date: Wed, 28 Oct 2009 22:32:00 GMT

Authorization: authorization string

Content-Length: 124

 

<AccessControlPolicy>

  <Owner>

    <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>

    <DisplayName>CustomersName@lecloud.com</DisplayName>

  </Owner>

  <AccessControlList>

    <Grant>

      <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="CanonicalUser">

<ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeeExampleCanonicalUserID</ID>

<DisplayName>CustomerName@lecloud.com</DisplayName>

      </Grantee>

      <Permission>FULL_CONTROL</Permission>

    </Grant>

  </AccessControlList>

</AccessControlPolicy>

返回示例

HTTP/1.1 200 OK

x-amz-id-2: eftixk72aD6Ap51T9AS1ed4OpIszj7UDNEHGran

x-amz-request-id: 318BC8BC148832E5

x-amz-version-id: 3/L4kqtJlcpXrof3vjVBH40Nr8X8gdRQBpUMLUo

Date: Wed, 28 Oct 2009 22:32:00 GMT

Last-Modified: Sun, 1 Jan 2006 12:00:00 GMT

Content-Length: 0

Connection: close

Server: nginx