# SetObjectAccessControlPolicy (API SOAP)
<a name="SOAPSetObjectAccessControlPolicy"></a>

**nota**  
 As APIs SOAP para o Amazon S3 não estão disponíveis para novos clientes e chegam ao fim da vida útil (EOL) em 31 de agosto de 2025. Recomendamos usar a API REST ou os AWS SDKs. 

A operação `SetObjectAccessControlPolicy` define a política de controle de acesso para um objeto existente. Se for bem-sucedida, a política de controle de acesso anterior do objeto será totalmente substituída pela política de controle de acesso especificada.

**Example**  
Este exemplo fornece ao usuário especificado (geralmente o proprietário) acesso `FULL_CONTROL` ao objeto "Nelson" do bucket "quotes".  
`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>
```

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

## Controle de acesso
<a name="SOAPSetObjectAccessControlPolicyAccessControl"></a>

Você deve ter direitos `WRITE_ACP` sobre o objeto para definir a política de controle de acesso de um bucket.