# Atribuir tags a recursos do S3 Files
<a name="s3-files-tagging"></a>

Para ajudar a gerenciar recursos do S3 Files, você pode atribuir seus próprios metadados a cada recurso em forma de tags. Com tags, você pode categorizar seus recursos AWS de diferentes maneiras, por exemplo, por finalidade, proprietário ou ambiente. Essa categorização é útil quando há muitos recursos do mesmo tipo, pois é possível identificar rapidamente um recurso específico com base nas tags atribuídas a ele. Você pode atribuir tags ao sistema de arquivos e a recursos de ponto de acesso do S3 que já existem na sua conta. Este tópico descreve tags e mostra a você como criá-las.

## Restrições de tags
<a name="s3-files-tagging-restrictions"></a>

As restrições básicas a seguir se aplicam a tags:
+ Número máximo de tags por recurso:- 50
+ Em todos os recursos, cada chave de tag deve ser exclusiva e possuir apenas um valor.
+ Comprimento máximo da chave:- 128 caracteres Unicode em UTF-8
+ Comprimento máximo do valor:- 256 caracteres Unicode em UTF-8
+ Os caracteres permitidos são: letras, números e espaços representáveis em UTF-8, além dos seguintes caracteres: `+ - = . _ : / @`.
+ As chaves e os valores de tags diferenciam maiúsculas de minúsculas.
+ O prefixo `aws:` é reservado para uso da AWS. Não é possível editar nem excluir a chave ou o valor de uma tag quando ela tem uma chave de tag com esse prefixo. As tags com o prefixo `aws:` não contam para as tags por limite de recurso.

Você não pode atualizar ou excluir um recurso com base apenas em suas tags; você deve especificar o identificador do recurso. Por exemplo, para excluir sistemas de arquivos marcados com uma chave de tag chamada `DeleteMe`, é necessário usar a ação `DeleteFileSystem` com os identificadores de recurso do sistema de arquivos, como o ID do sistema de arquivos.

Ao marcar recursos públicos ou compartilhados, as tags atribuídas ficam disponíveis somente para sua conta da AWS. Nenhuma outra conta da AWS terá acesso a essas tags. Para controle de acesso baseado em tags a recursos compartilhados, cada conta da AWS deve atribuir seu próprio conjunto de tags para controlar o acesso ao recurso.

## Usar o console do S3
<a name="s3-files-tagging-console"></a>

O console do S3 Files pode ser usado para gerenciar tags em seus recursos.
+ Abra o console do Amazon S3, em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
+ Na barra de navegação, na parte superior da página, verifique se você está na região da AWS desejada.
+ No painel de navegação à esquerda, selecione **Sistemas de arquivos**.
+ É possível especificar tags para um recurso ao criá-lo, como um sistema de arquivos ou um ponto de acesso do S3. Ou você pode adicionar modificar ou excluir tags após a criação acessando as propriedades do recurso.

## Como usar o AWS CLI
<a name="s3-files-tagging-cli"></a>

Caso esteja usando a API do S3 Files, a AWS CLI, ou um SDK da AWS, você poderá usar a ação de API `TagResource` do S3 Files para aplicar tags aos recursos existentes. Além disso, algumas ações de criação de recursos permitem que especificar tags para um recurso quando ele é criado, como quando você cria um sistema de arquivos.

Os comandos da AWS CLI para gerenciar tags e as ações de API equivalentes do S3 Files estão listados na tabela a seguir.


| Comando da CLI | Descrição | Operação de API equivalente | 
| --- | --- | --- | 
| tag-resource | Adicionar novas tags ou atualizar as existentes | TagResource | 
| list-tags-for-resource | Recuperar tags existentes | ListTagsForResource | 
| untag-resource | Excluir tags existentes | UntagResource |