# Adicionar uma tag a uma tabela
<a name="table-tag-add"></a>



É possível adicionar tags às tabelas do Amazon S3 e modificá-las. Para ter mais informações sobre marcação de tabelas, consulte [Usar tags com tabelas do S3](table-tagging.md).

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

Para adicionar uma tag a uma tabela, é necessário ter a seguinte permissão:
+ `s3tables:TagResource`

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

Se você encontrar um erro ao tentar adicionar uma tag a uma tabela, é possível fazer o seguinte: 
+ Verifique se você tem as [Permissões](#table-tag-add-permissions) necessárias para adicionar uma tag a uma tabela.
+ Se você tentou adicionar uma chave de tag que começa com o prefixo reservado `aws:` da AWS, altere-a e tente novamente. 
+ A chave de tag é obrigatória. Além disso, a chave e o valor da tag não devem exceder a extensão máxima de caracteres e não devem conter caracteres restritos. Para obter mais informações, consulte [Atribuir tags para alocação de custos ou controle de acesso por atributo (ABAC)](tagging.md).

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

É possível adicionar tags a tabelas usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), a API REST da funcionalidade Tabelas do Amazon S3 e SDKs da AWS.

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

Adicionar tags a uma tabela 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 tabela**.

1. Escolha o nome do bucket de tabela. 

1. Escolha o nome da tabela. 

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

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

Para ter informações sobre a compatibilidade oferecida pela API REST do Amazon S3 para adicionar tags a uma tabela, 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_s3Buckets_TagResource.html)

## Como usar o AWS CLI
<a name="table-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 uma tabela 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 --region {{us-west-2}} \ 
s3tables tag-resource \
--resource-arn arn:aws::s3tables:{{us-west-2}}:{{111122223333}}:bucket/{{amzn-s3-demo-table-bucket}}/table/{{my_example_table}} \
--tags '{"Department":"engineering"}'
```