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



É 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](https://docs.aws.amazon.com/s3/pricing/). Para ter mais informações sobre marcação de buckets de diretório, consulte [Usar tags com buckets de diretório do S3](directory-buckets-tagging.md).

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

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

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

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](#tag-add-permissions) 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
<a name="tag-add-steps"></a>

É 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.

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

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/](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 escolha **Adicionar nova tag**. 

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

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

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

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

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

------
#### [ 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());
    }
}
```

------

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

Para ter informações sobre a compatibilidade oferecida pela 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*:
+ [TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html)

## Como usar o AWS CLI
<a name="directory-bucket-tag-add-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 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
  }
}
```