# DeleteObject (API SOAP)
<a name="SOAPDeleteObject"></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 `DeleteObject` remove o objeto especificado do Amazon S3. Depois de excluído, não há método para restaurar ou recuperar um objeto.

**nota**  
Se você excluir um objeto que não existe, o Amazon S3 retornará um sucesso (não uma mensagem de erro). 

**Example**  
Este exemplo exclui o objeto "Nelson" do bucket "quotes".  
`Sample Request`  

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

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

## Elementos
<a name="SOAPDeleteObjectElements"></a>
+ `Bucket:` O bucket que contém o objeto.
+ `Key:` A chave que identifica o objeto.

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

Você só pode excluir um objeto se tiver acesso `WRITE` ao bucket, independentemente de quem é o proprietário do objeto ou de quais direitos são concedidos a ele.