# DeleteBucket (API SOAP)
<a name="SOAPDeleteBucket"></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 `DeleteBucket` exclui um bucket. Todos os objetos no bucket devem ser excluídos antes que o bucket em si possa ser excluído.

**Example**  
Este exemplo exclui o bucket “quotes”.  
`Sample Request`  

```
1. <DeleteBucket xmlns="https://doc.s3.amazonaws.com/2006-03-01">
2.   <Bucket>quotes</Bucket>
3.   <AWSAccessKeyId> AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
4.   <Timestamp>2006-03-01T12:00:00.183Z</Timestamp>
5.   <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature>
6. </DeleteBucket>
```
`Sample Response`  

```
1. <DeleteBucketResponse xmlns="https://s3.amazonaws.com/doc/2006-03-01">
2.   <DeleteBucketResponse>
3.     <Code>204</Code>
4.     <Description>No Content</Description>
5.   </DeleteBucketResponse>
6. </DeleteBucketResponse>
```

## Elementos
<a name="SOAPDeleteBucketElements"></a>
+ `Bucket:` O nome do bucket que você deseja excluir.

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

Somente o proprietário do bucket tem permissão para excluí-lo, independentemente da política de controle de acesso no bucket.