# Excluir uma tag de um bucket de diretório
<a name="directory-bucket-tag-delete"></a>

É possível remover tags dos buckets de diretório do S3. Uma tag da AWS é um par de chave-valor que contém metadados sobre recursos, neste caso buckets de diretório do Amazon S3. Para obter mais informações sobre tags, consulte [Usar tags com buckets de diretório do S3](directory-buckets-tagging.md).

**nota**  
Se você excluir uma tag e depois descobrir que ela estava sendo usada para rastrear custos ou controlar o acesso, poderá adicionar a tag novamente ao bucket de diretório. 

## Permissões
<a name="tag-delete-permissions"></a>

Para excluir uma tag de um bucket de diretório, você precisa ter a seguinte permissão: 
+ `s3express:UntagResource`

## Solucionar de problemas de erros
<a name="tag-delete-troubleshooting"></a>

Se você encontrar um erro ao tentar excluir uma tag de um bucket de diretório, é possível fazer o seguinte: 
+ Verifique se você tem as [Permissões](#tag-delete-permissions) necessárias para adicionar uma tag a um bucket de diretório.

## Etapas
<a name="tag-delete-steps"></a>

Você pode excluir tags de buckets de diretório usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), a API REST do Amazon S3 e os SDKs da AWS.

## Usar o console do S3
<a name="directory-bucket-tag-delete-console"></a>

Para excluir tags de um bucket de diretório usando o console do Amazon S3:

1. Faça login no console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, escolha **Buckets de diretório**.

1. Escolha o nome do bucket. 

1. Escolha a guia **Properties (Propriedades)**. 

1. Role até a seção **Tags** e marque a caixa de seleção ao lado das tags que você gostaria de excluir. 

1. Escolha **Excluir**. 

1. O pop-up **Excluir etiquetas definidas pelo usuário** é exibido e solicita que você confirme a exclusão das tags selecionadas. 

1. Escolha **Delete** para confirmar.

## Usar SDKs da AWS
<a name="directory-bucket-tag-delete-sdks"></a>

------
#### [ SDK for Java 2.x ]

Este exemplo mostra como excluir tags de um bucket de diretório usando o AWS SDK for Java 2.x. Para usar o comando, substitua os {{espaços reservados para entrada do usuário}} por suas próprias informações. 

```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.UntagResourceRequest;
import software.amazon.awssdk.services.s3control.model.UntagResourceResponse;

public class UntagResourceExample {
    public static void untagResourceExample() {
        S3ControlClient s3Control = S3ControlClient.builder().region(Region.{{US_WEST_2}}).build();

        UntagResourceRequest untagResourceRequest = UntagResourceRequest.builder()
                .resourceArn("arn:aws::s3express:{{us-west-2}}:{{111122223333}}:bucket/my-directory-bucket--{{usw2-az1}}--x-s3")
                .accountId("{{111122223333}}")
                .tagKeys("{{myTagKey}}")
                .build();

        UntagResourceResponse response = s3Control.untagResource(untagResourceRequest);
        System.out.println("Status code (should be 204):");
        System.out.println(response.sdkHttpResponse().statusCode());
    }
}
```

------

## Uso da API REST
<a name="directory-bucket-tag-delete-api"></a>

Para ter informações sobre a compatibilidade oferecida pela API REST do Amazon S3 para excluir tags de um bucket de diretório, consulte a seguinte seção na *Referência de API do Amazon Simple Storage Service*:
+ [UnTagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html)

## Como usar o AWS CLI
<a name="directory-bucket-tag-delete-cli"></a>

Para instalar a AWS CLI, consulte [Instalar ou atualizar a versão mais recente da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) no *Guia do usuário da versão 2 da AWS Command Line Interface*.

O exemplo da CLI a seguir mostra como excluir tags de um bucket de diretório usando a AWS CLI. Para usar o comando, substitua os {{espaços reservados para entrada do usuário}} por suas próprias informações.

**Solicitação:**

```
aws s3control untag-resource \
--account-id {{111122223333}} \
--resource-arn arn:aws::s3express:{{us-east-1}}:{{444455556666}}:bucket/prefix--{{use1-az4}}--x-s3 \
--tag-keys "{{tagkey1}}" "{{tagkey2}}"
```

**Resposta:**

```
{
  "ResponseMetadata": {
    "RequestId": "EXAMPLE123456789",
    "HTTPStatusCode": 204,
    "HTTPHeaders": {
        "date": "Wed, 19 Jun 2025 10:30:00 GMT",
        "content-length": "0"
    },
    "RetryAttempts": 0
  }
}
```