

# SetBucketAccessControlPolicy (API SOAP)
<a name="SOAPSetBucketAccessControlPolicy"></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 `SetBucketAccessControlPolicy` define a política de controle de acesso para um bucket existente. Se for bem-sucedida, a política de controle de acesso anterior do bucket será totalmente substituída pela política de controle de acesso especificada.

**Example**  
Dê ao usuário especificado (geralmente o proprietário) acesso `FULL_CONTROL` ao bucket “quotes”.  
`Sample Request`  

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

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

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

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