

# SetObjectAccessControlPolicy（SOAP API）
<a name="SOAPSetObjectAccessControlPolicy"></a>

**注意**  
 Amazon S3 的 SOAP API 不适用于新客户，并将于 2025 年 8 月 31 日接近使用寿命终止（EOL）。我们建议您使用 REST API 或 AWS SDK。

`SetObjectAccessControlPolicy` 操作为现有对象设置访问控制策略。如果成功，该对象先前的访问控制策略将完全替换为指定的访问控制策略。

**Example**  
本示例向指定的用户（通常是拥有者）授予对“quotes”存储桶中“Nelson”对象的 `FULL_CONTROL` 访问权限。  
`Sample Request`  

```
 1. <SetObjectAccessControlPolicy xmlns="https://doc.s3.amazonaws.com/2006-03-01">
 2.   <Bucket>quotes</Bucket>
 3.   <Key>Nelson</Key>
 4.   <AccessControlList>
 5.     <Grant>
 6.       <Grantee xsi:type="CanonicalUser">
 7.         <ID>a9a7b886d6fd24a52fe8ca5bef65f89a64e0193f23000e241bf9b1c61be666e9</ID>
 8.         <DisplayName>chriscustomer</DisplayName>
 9.       </Grantee>
10.       <Permission>FULL_CONTROL</Permission>
11.     </Grant>
12.   </AccessControlList>
13.   <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
14.   <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
15.   <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
16. </SetObjectAccessControlPolicy>
```
`Sample Response`  

```
1. <SetObjectAccessControlPolicyResponse xmlns="https://s3.amazonaws.com/doc/2006-03-01">
2.   <SetObjectAccessControlPolicyResponse>
3.     <Code>200</Code>
4.     <Description>OK</Description>
5.   </SetObjectAccessControlPolicyResponse>
6. </SetObjectAccessControlPolicyResponse>
```

## Key
<a name="SOAPSetObjectAccessControlPolicyKey"></a>

## 访问控制
<a name="SOAPSetObjectAccessControlPolicyAccessControl"></a>

您必须对该对象拥有 `WRITE_ACP` 权限才能设置存储桶的访问控制策略。