# Excluir um objeto de um bucket com exclusão de MFA habilitada
<a name="UsingMFADelete"></a>

Quando você configura a exclusão de MFA, somente o usuário-raiz pode excluir permanentemente as versões do objeto ou alterar a configuração de versão no seu bucket do S3. Você deve usar um dispositivo de MFA para autenticar o usuário-raiz para realizar a ação de exclusão.

Se a configuração de versionamento do bucket tiver a exclusão de MFA ativada, o proprietário do bucket deverá incluir o cabeçalho de solicitação `x-amz-mfa` nas solicitações para excluir permanentemente uma versão de objeto ou alterar o estado de versionamento do bucket. As solicitações que incluem `x-amz-mfa` devem usar HTTPS.

O valor do cabeçalho é uma concatenação do número de série do seu dispositivo de autenticação, um espaço e o código de autenticação exibido nele. Se você não incluir esse cabeçalho, a solicitação falhará.

Ao usar a AWS CLI, inclua as mesmas informações do valor do parâmetro `mfa`.

Para obter mais informações sobre dispositivos de autenticação, consulte [Autenticação multifator](https://aws.amazon.com/iam/details/mfa/).

Para obter mais informações sobre ativação de exclusão de MFA, consulte [Configurando a exclusão de MFA](MultiFactorAuthenticationDelete.md).

**nota**  
Não é possível usar o Console de gerenciamento da AWS para excluir um objeto em um bucket com versionamento habilitado que tem exclusão de MFA.

## Como usar o AWS CLI
<a name="MFADeleteCLI"></a>

Para excluir um objeto em um bucket com versionamento habilitado que tem exclusão de MFA habilitada, use o comando a seguir. Ao usar o comando de exemplo a seguir, substitua os `user input placeholders` por suas próprias informações.

```
 aws s3api delete-object --bucket amzn-s3-demo-bucket --key OBJECT-KEY --version-id "VERSION ID" --mfa "MFA_DEVICE_SERIAL_NUMBER MFA_DEVICE_CODE"						
```

## Uso da API REST
<a name="MFADeleteAPI"></a>

O exemplo a seguir exclui `my-image.jpg` (com a versão especificada), que está em um bucket configurado com a exclusão de MFA habilitada. 

Para ter mais informações, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html) na “Referência de API do Amazon Simple Storage Service”.

```
1. DELETE /my-image.jpg?versionId=3HL4kqCxf3vjVBH40Nrjfkd HTTPS/1.1
2. Host: bucketName.s3.amazonaws.com
3. x-amz-mfa: 20899872 301749
4. Date: Wed, 28 Oct 2009 22:32:00 GMT
5. Authorization: AWS AKIAIOSFODNN7EXAMPLE:0RQf4/cRonhpaBX5sCYVf1bNRuU=
```