

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

# Marcar seus grupos do Auto Scaling
<a name="add-tags"></a>

Quando você adiciona uma tag a seu grupo do Auto Scaling, você pode especificar se ela deve ser adicionada às instâncias iniciadas no grupo do Auto Scaling. Se você modificar uma tag, a versão atualizada da tag será adicionada às instâncias executadas no grupo do Auto Scaling depois da alteração. Se você criar ou modificar uma tag em um grupo do Auto Scaling, essas alterações não serão feitas em instâncias que já estão em execução no grupo do Auto Scaling.

**Topics**
+ [Adicionar ou modificar tags (console)](#add-tags-console)
+ [Adicionar ou modificar tags (AWS CLI)](#add-tags-aws-cli)

## Adicionar ou modificar tags (console)
<a name="add-tags-console"></a>

**Para marcar um grupo do Auto Scaling na criação**  
Ao usar o console do Amazon EC2 para criar um grupo do Auto Scaling, você pode especificar valores e chaves de tags na página **Add tags** (Configurar tags) do assistente de criação de grupo do Auto Scaling. Para propagar uma tag às instâncias executadas no grupo do Auto Scaling, mantenha a opção **Tag New Instances** (Marcar novas instâncias) para essa tag selecionada. Caso contrário, desmarque-a. 

**Para adicionar ou modificar tags de um grupo do Auto Scaling existente**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)e escolha **Auto Scaling Groups** no painel de navegação.

1. Marque a caixa de seleção ao lado do grupo do Auto Scaling.

   Um painel dividido é aberto na parte inferior da página **Auto Scaling groups** (Grupos do Auto Scaling). 

1. Na guia **Detalhes** escolha **Tags**, **Editar**.

1. Para modificar as tags existentes, edite **Chave** e **Valor**.

1. Para adicionar uma nova tag, escolha **Adicionar tag** e edite **Chave** e **Valor**. É possível manter a opção **Tag new instances** (Marcar novas instâncias) selecionada para adicionar a tag às instâncias executadas no grupo do Auto Scaling automaticamente e, caso contrário, desmarcá-la.

1. Ao concluir a inclusão de tags, selecione **Update (Atualizar)**.

## Adicionar ou modificar tags (AWS CLI)
<a name="add-tags-aws-cli"></a>

Os exemplos a seguir mostram como usar o para adicionar tags AWS CLI ao criar grupos de Auto Scaling e para adicionar ou modificar tags para grupos de Auto Scaling existentes. 

**Para marcar um grupo do Auto Scaling na criação**  
Use o [create-auto-scaling-group](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/create-auto-scaling-group.html)comando para criar um novo grupo de Auto Scaling e adicionar uma tag, por exemplo**environment=production**, ao grupo Auto Scaling. A tag também é adicionada a todas as instâncias executadas no grupo do Auto Scaling.

```
aws autoscaling create-auto-scaling-group --auto-scaling-group-name {{my-asg}} \
  --launch-configuration-name {{my-launch-config}} --min-size {{1}} --max-size {{3}} \
  --vpc-zone-identifier "{{subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782}}" \
  --tags Key={{environment}},Value={{production}},PropagateAtLaunch=true
```

**Para criar ou modificar tags de um grupo do Auto Scaling existente**  
Use o comando [create-or-update-tags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/create-or-update-tags.html) para criar ou modificar uma tag. Por exemplo, o comando a seguir adiciona as tags `costcenter=cc123` e `Name=my-asg`. As tags também são adicionadas a todas as instâncias executadas no grupo do Auto Scaling após essa alteração. Se uma tag com uma dessas chaves já existir, a tag existente será substituída. O console do Amazon EC2 associa o nome de exibição para cada instância ao nome especificado para a chave `Name` (diferencia maiúsculas de minúsculas).

```
aws autoscaling create-or-update-tags \
  --tags ResourceId={{my-asg}},ResourceType=auto-scaling-group,Key=Name,Value={{my-asg}},PropagateAtLaunch=true \
  ResourceId={{my-asg}},ResourceType=auto-scaling-group,Key={{costcenter}},Value={{cc123}},PropagateAtLaunch=true
```

### Descrever as tags para um grupo do Auto Scaling (AWS CLI)
<a name="describe-tags-aws-cli"></a>

Se você deseja visualizar as tags que são aplicadas à uma função do Auto Scaling específica, pode usar os seguintes comandos: 
+ [describe-tags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-tags.html): - você fornece o nome do grupo do Auto Scaling para visualizar uma lista das tags do grupo especificado.

  ```
  aws autoscaling describe-tags --filters Name=auto-scaling-group,Values={{my-asg}}
  ```

  O seguinte é um exemplo de resposta.

  ```
  {
      "Tags": [
          {
              "ResourceType": "auto-scaling-group",
              "ResourceId": "my-asg",
              "PropagateAtLaunch": true,
              "Value": "production",
              "Key": "environment"
          }
      ]
  }
  ```
+ [describe-auto-scaling-groups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-auto-scaling-groups.html)— Você fornece o nome do grupo do Auto Scaling para visualizar os atributos do grupo especificado, incluindo quaisquer tags.

  ```
  aws autoscaling describe-auto-scaling-groups --auto-scaling-group-name {{my-asg}}
  ```

  O seguinte é um exemplo de resposta.

  ```
  {
      "AutoScalingGroups": [
          {
              "AutoScalingGroupName": "my-asg",
              "AutoScalingGroupARN": "{{arn}}",
              "LaunchTemplate": {
                  "LaunchTemplateId": "lt-0b97f1e282EXAMPLE",
                  "LaunchTemplateName": "my-launch-template",
                  "Version": "$Latest"
              },
              "MinSize": 1,
              "MaxSize": 5,
              "DesiredCapacity": 1,
              ...
              "Tags": [
                  {
                      "ResourceType": "auto-scaling-group",
                      "ResourceId": "my-asg",
                      "PropagateAtLaunch": true,
                      "Value": "production",
                      "Key": "environment"
                  }
              ],
              ...
          }
      ]
  }
  ```