Adicionar uma tag a um bucket de diretório - Amazon Simple Storage Service
PermissõesSolucionar de problemas de errosEtapas

Adicionar uma tag a um bucket de diretório

É possível adicionar tags aos buckets de diretório do Amazon S3 e modificá-las. Não há cobrança adicional para usar tags em buckets de diretório além das taxas de solicitação padrão da API do S3. Para obter mais informações, consulte Preço do Amazon S3. Para ter mais informações sobre marcação de buckets de diretório, consulte Usar tags com buckets de diretório do S3.

Permissões

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

  • s3express:TagResource

Solucionar de problemas de erros

Se você encontrar um erro ao tentar adicionar uma tag a um bucket de diretório, você pode fazer o seguinte:

  • Verifique se você tem as Permissões necessárias para adicionar uma tag a um bucket 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 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.

Para adicionar tags a 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/.

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

  3. Escolha o nome do bucket.

  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.

SDK for Java 2.x

Este exemplo mostra como adicionar tags a 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.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:s3express:us-west-2:111122223333:bucket/my-directory-bucket--usw2-az1--x-s3")
                .accountId("111122223333")
                .tags(Tag.builder().key("MyTagKey").value("MyTagValue").build())
                .build();

        TagResourceResponse response = s3Control.tagResource(tagResourceRequest);
        System.out.println("Status code (should be 204):");
        System.out.println(response.sdkHttpResponse().statusCode());
    }
}

Para ter informações sobre a compatibilidade da API REST do Amazon S3 para adicionar tags a um bucket de diretório, consulte a seguinte seção na “Referência de API do Amazon Simple Storage Service”:

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:us-east-1:444455556666:bucket/prefix--use1-az4--x-s3 \
--tags "Key=mykey,Value=myvalue"

Resposta:

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