Atribuir tags a recursos do S3 Files
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
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 prefixoaws: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.
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/
. 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.
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 |
