Excluir uma tag de um ponto de acesso para buckets de diretório

É possível remover tags de um ponto de acesso para buckets de diretório. Para ter informações adicionais, consulte Usar tags com o recurso Pontos de Acesso S3 para buckets de diretório.

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 ponto de acesso para buckets de diretório.

Permissões

Para excluir uma tag de um ponto de acesso para buckets de diretório, você precisa ter a seguinte permissão:

• s3express:UntagResource

Solucionar erros

Se você encontrar um erro ao tentar excluir uma tag de um ponto de acesso para buckets de diretório, é possível fazer o seguinte:

• Verifique se você tem as Permissões necessárias para excluir uma tag de um ponto de acesso para buckets de diretório.

Etapas

Você pode excluir tags de pontos de acesso para 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.

Uso do console do S3

Para excluir tags de um ponto de acesso para buckets 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/.

2. No painel de navegação à esquerda, escolha Pontos de acesso (buckets de diretório).

3. Escolha o nome do ponto de acesso.

4. Escolha a guia Properties (Propriedades).

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

6. Escolha Excluir.

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

8. Escolha Delete para confirmar.

Uso da SDKs AWS

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.ListTagsForResourceRequest;
import software.amazon.awssdk.services.s3control.model.ListTagsForResourceResponse;

public class ListTagsForResourceExample {
    public static void listTagsForResourceExample() {
        S3ControlClient s3Control = S3ControlClient.builder().region(Region.US_WEST_2).build();

        UntagResourceRequest untagResourceRequest = UntagResourceRequest.builder()
                .resourceArn("arn:aws::s3:region:111122223333:accesspoint/my-access-point/*")
                .accountId("111122223333")
                .tagKeys("key1")
                .build();

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

Uso dos REST API

Para ter informações sobre a compatibilidade oferecida pela API REST do Amazon S3 para excluir tags de um ponto de acesso, consulte a seguinte seção na Referência de API do Amazon Simple Storage Service:

• UnTagResource

Como usar a AWS CLI

Para instalar a AWS CLI, consulte Instalar ou atualizar a versão mais recente da AWS CLI 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 ponto de acesso para buckets 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::s3:region:111122223333:accesspoint/my-access-point/* \
--tag-keys "key1" "key2"

Resposta:

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