Adicionar uma tag a um ponto de acesso para buckets de diretório

É possível adicionar tags a pontos de acesso para buckets de diretório do Amazon S3 e modificá-las. Para ter informações adicionais, consulte Usar tags com o recurso Pontos de Acesso S3 para buckets de diretório.

Permissões

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

• s3express:TagResource

Solucionar erros

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

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

• Se você tentou adicionar uma chave de tag que começa com o prefixo reservado aws: da AWS, altere-a e tente novamente.

Etapas

É possível adicionar tags a 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 SDKs da AWS.

Uso do console do S3

Para adicionar tags a 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 escolha Adicionar nova tag.

6. Isso abre a página Adicionar tags. É possível adicionar até cinquenta pares de chave-valor de tag.

7. Se você adicionar uma nova tag com a mesma chave de uma tag existente, o valor da nova sobrescreverá o valor da tag existente.

8. Nessa página, também é possível editar os valor das tags existentes.

9. Depois de adicionar as tags, escolha Salvar alterações.

Uso da SDKs AWS

SDK for Java 2.x

Este exemplo mostra como adicionar tags a um ponto de acesso para buckets 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.Tag;
import software.amazon.awssdk.services.s3control.model.TagResourceRequest;
import software.amazon.awssdk.services.s3control.model.TagResourceResponse;

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

        TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
                .resourceArn("arn:aws::s3:region:111122223333:accesspoint/my-access-point/*")
                .accountId("111122223333")
                .tags(Tag.builder().key("key1").value("value1").build())
                .build();

        TagResourceResponse response = s3Control.tagResource(tagResourceRequest);
        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 adicionar tags a um ponto de acesso para buckets de diretório, consulte a seguinte seção na Referência de API do Amazon Simple Storage Service:

• TagResource

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 adicionar tags a 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 tag-resource \
--account-id 111122223333 \
--resource-arn arn:aws::s3express:region:444455556666:bucket/prefix--use1-az4--x-s3 \
--tags "Key=key1,Value=value1"

Resposta:

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