As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Tags
**Importante**
O AWS OpsWorks Stacks serviço chegou ao fim da vida útil em 26 de maio de 2024 e foi desativado para clientes novos e existentes. É altamente recomendável que os clientes migrem suas cargas de trabalho para outras soluções o mais rápido possível. Se você tiver dúvidas sobre migração, entre em contato com a AWS Support equipe no [AWS re:POST](https://repost.aws/) ou por meio do Premium [AWS Support](https://aws.amazon.com/support).
Tags podem ajudá-lo a agrupar recursos nas pilhas do Chef 11.10, Chef 12 e Chef 12.2 e rastrear os custos de uso desses recursos no [Gerenciamento de Faturamento e Custos da AWS](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-what-is.html).
Você pode aplicar tags no nível de camada e pilha. Quando você cria uma tag, está aplicando-a para cada recurso dentro da estrutura com a tag. Por exemplo, se você aplica uma tag a uma camada, está aplicando a tag a cada instância, volume do Amazon EBS (exceto o root) ou balanceador de carga do Elastic Load Balancing na camada. Atualmente, as tags não podem ser aplicadas à raiz, ou padrão, volume do EBS de uma instância.
Tags são pares de valores-chave que você atribui a pilhas ou camadas em Pilhas. OpsWorks Depois de criar tags, abra o console do Faturamento e gerenciamento de custos para ativar tags definidas pelo usuário. Para obter mais informações sobre como ativar suas tags e usá-las para rastrear e gerenciar os custos dos recursos do OpsWorks Stacks, consulte [Usando tags de alocação de custos e ativando tags de alocação](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) [de custos definidas pelo usuário](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/activating-tags.html) no *Billing and Cost Management* User Guide.
As tags funcionam de forma semelhante aos atributos personalizados no OpsWorks Stacks. As tags que você aplica a uma pilha são herdadas por cada camada na pilha. No nível da camada, você pode substituir os valores (mas não os nomes das chaves) das tags herdadas e adicionar novas tags específicas da camada. OpsWorks aplica o conjunto de tags resultante a todos os recursos na camada. Conforme você cria novos ou atribui recursos existentes a uma camada, os novos recursos na camada são marcados com o mesmo grupo de tags.
**Topics**
+ [Definição de tags no nível da pilha](#w2ab1c14c63c15)
+ [Definição de tags no nível da camada](#w2ab1c14c63c17)
+ [Gerenciando tags com o AWS CLI](#w2ab1c14c63c19)
+ [Limitações de tag](#w2ab1c14c63c21)
## Definição de tags no nível da pilha
No nível da pilha, você pode adicionar e gerenciar tags escolhendo **Tags** na página inicial da pilha.
![\[Tags section with icon and description for applying tags to stack resources.\]](http://docs.aws.amazon.com/pt_br/opsworks/latest/userguide/images/stack_tags.png)
Na página **Tags**, adicione tags como pares chave-valor. A captura de tela a seguir mostra algumas tags de exemplo. Você pode excluir tags marcando o **X** em vermelho à direita do par chave-valor.
![\[Tags interface showing key-value pairs for Organization and Staging, with options to add or delete tags.\]](http://docs.aws.amazon.com/pt_br/opsworks/latest/userguide/images/stack_tags_add.png)
## Definição de tags no nível da camada
No nível da camada, defina tags escolhendo a guia **Tags**. Você pode encontrar essa guia na página inicial **Layers (Camadas)**, e na página inicial de cada camada individual.
![\[List of layers including ELB, HAProxy, Rails, PHP, Node.js, and MySQL with configuration options.\]](http://docs.aws.amazon.com/pt_br/opsworks/latest/userguide/images/layers_tags.png)
Quando você muda ou adiciona tags no nível da camada, esteja ciente de que as tags adicionadas no nível da pilha parente são herdadas pela camada e seus recursos. Por mais que você possa mudar os valores das tags herdadas, não pode mudar os nomes-chave ou excluir tags herdadas. Alterar os nomes-chave ou excluir tags herdadas da pilha parente nas configurações de pilha. A captura de tela a seguir mostra exemplos de tags herdadas do nível da pilha. Tags herdadas estão desabilitadas.
![\[Tags interface showing inherited and editable fields for Organization and Staging keys.\]](http://docs.aws.amazon.com/pt_br/opsworks/latest/userguide/images/layer_inherited_tags.png)
Para obter mais informações sobre como adicionar tags a pilhas, consulte [Criar uma nova pilha](workingstacks-creating.md). Para obter mais informações sobre como adicionar tags a camadas, consulte [Editando a configuração de uma OpsWorks camada](workinglayers-basics-edit.md).
## Gerenciando tags com o AWS CLI
Você também pode usar AWS CLI comandos para adicionar e remover tags no nível da pilha e da camada. Para obter mais informações sobre como baixar e instalar o AWS CLI, consulte [Instalando a interface de linha de AWS comando](https://docs.aws.amazon.com/cli/latest/userguide/installing.html). Lembre-se de adicionar o parâmetro `--region` ao seu comando se a pilha que você deseja marcar não está em sua região padrão. Atualmente, as camadas ARNs não aparecem no Console de gerenciamento da AWS. Para obter o ARN da camada, execute o comando [describe-layers](https://docs.aws.amazon.com/cli/latest/reference/opsworks/describe-layers.html).
**Para adicionar tags usando o AWS CLI**
+ **No prompt de AWS CLI comando, digite o comando a seguir, substituindo *stack\$1or\$1layer\$1ARN* e especificando suas tags de pares de valores-chave e pressione Enter.** Pontos de interrogação duplos são recuados com barras invertidas.
```
aws opsworks tag-resource --resource-arn stack_or_layer_ARN --tags "{\"key\":\"value\",\"key\":\"value\"}"
```
Veja um exemplo do a seguir:
```
aws opsworks tag-resource --resource-arn arn:aws:opsworks:us-east-2:800000000003:stack/500b99c0-ec00-4cgg-8a0d-1000000jjd1b --tags "{\"Stage\":\"Production\",\"Organization\":\"Mobile\"}"
```
**Para remover tags usando o AWS CLI**
+ No prompt de AWS CLI comando, digite o seguinte e pressione **Enter**.
```
aws opsworks untag-resource --resource-arn stack_or_layer_ARN --tag-keys "[\"key\",\"key\"]"
```
Para remover tags, você especifica apenas a chave da tag que deseja remover. Veja um exemplo do a seguir:
```
aws opsworks untag-resource --resource-arn arn:aws:opsworks:us-east-2:800000000003:stack/500b99c0-ec00-4cgg-8a0d-1000000jjd1b --tag-keys "[\"Stage\",\"Organization\"]"
```
**nota**
Você não pode remover tags herdadas (tags que foram adicionadas ao nível de pilha parente) de uma camada. Em vez disso, remova tags herdadas da pilha.
## Limitações de tag
Mantenha as seguintes limitações em mente ao criar tags.
+ OpsWorks As pilhas limitam o número de tags definidas pelo usuário no nível da pilha e da camada a 40, incluindo tags definidas pelo usuário herdadas de um nível principal. Isso deixa 10 slots disponíveis para tags padrão prefixadas com `opsworks:` e tags definidas por outros AWS processos. É permitido um máximo de 50 tags em um recurso, incluindo tags definidas pelo usuário e tags padrão criadas por AWS.
+ Chaves de tags não podem começar com **aws:**, **opsworks:** ou **rds:**. Não use **name** ou **Name** como chave de tag, pois **Name** é reservada pelo OpsWorks Stacks.
+ Uma chave por ter, no máximo, 127 caracteres, e pode conter apenas letras de código único, números ou separadores, ou os caracteres especiais a seguir: `+ - = . _ : / `.
+ Um valor pode ter, no máximo, 255 caracteres, e conter apenas letras de código único, números ou separadores, ou os caracteres especiais a seguir: `+ - = . _ : / `.