本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 標記 Auto Scaling 群組
<a name="add-tags"></a>

在將標籤新增到 Auto Scaling 群組時，您可以選擇是否要新增已啟動的執行個體到 Auto Scaling 群組。假設您修改了標籤，在變更後完成後，標籤的更新版本會新增到 Auto Scaling 群組中已啟動的執行個體。如果您建立或修改 Auto Scaling 群組的標籤，這些變更不會套用到已在 Auto Scaling 群組中執行的執行個體。

**Topics**
+ [新增或修改標籤 (主控台)](#add-tags-console)
+ [新增或修改標籤 (AWS CLI)](#add-tags-aws-cli)

## 新增或修改標籤 (主控台)
<a name="add-tags-console"></a>

**若要在建立時標記 Auto Scaling 群組**  
在使用 Amazon EC2 主控台建立 Auto Scaling 群組時，您可以在 Create Auto Scaling Group (建立 Auto Scaling 群組) 精靈中的 **Add tags** (新增標籤) 頁面上指定標籤鍵和值。若要將標籤傳播至 Auto Scaling 群組中啟動的執行個體，請確定您有保留選取該標籤的 **Tag new instances** (標記新的執行個體) 選項。否則，您可加以取消選取。

**在現有 Auto Scaling 群組中新增或修改標籤**

1. 前往網址 [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) 開啟 Amazon EC2 主控台，然後從導覽窗格中選擇 **Auto Scaling 群組**。

1. 選取 Auto Scaling 群組旁的核取方塊。

   **Auto Scaling groups** (Auto Scaling 群組) 頁面底部會開啟一個分割窗格。

1. 在 **Details** (詳細資訊) 索引標籤上，依次選擇 **Tags** (標籤)、**Edit** (編輯)。

1. 若要修改現有標籤，請編輯 **Key (鍵)** 和 **Value (值)**。

1. 若要新增標籤，請選擇 **Add tag (新增標籤)**，然後編輯 **Key (鍵)** 和 **Value (值)**。您可以繼續選取 **Tag new instances** (標記新的執行個體)，以自動將標籤新增到 Auto Scaling 群組中啟動的執行個體。否則，請取消該選取。

1. 當您完成新增標籤的作業時，請選擇 **Update** (更新)。

## 新增或修改標籤 (AWS CLI)
<a name="add-tags-aws-cli"></a>

下列範例示範如何在建立 Auto Scaling 群組時使用 AWS CLI 新增標籤，以及新增或修改現有 Auto Scaling 群組的標籤。

**若要在建立時標記 Auto Scaling 群組**  
使用 [create-auto-scaling-group](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/create-auto-scaling-group.html) 命令來建立新的 Auto Scaling 群組並新增標籤，例如新增 **environment=production** 至 Auto Scaling 群組。此標籤也會新增至 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
```

**在現有 Auto Scaling 群組中建立或修改標籤**  
使用 [create-or-update-tags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/create-or-update-tags.html) 命令來建立或修改標籤。例如，以下命令會新增 `Name=my-asg` 和 `costcenter=cc123` 標籤。在此變更之後，這兩個標籤也會新增至 Auto Scaling 群組中啟動的任何執行個體。如果具有任一鍵的標籤已存在，則現有的標籤會被取代。Amazon EC2 主控台會將每個執行個體的顯示名稱關聯至為 `Name` 鍵指定的名稱 (區分大小寫)。

```
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
```

### 描述 Auto Scaling 群組 (AWS CLI) 的標籤
<a name="describe-tags-aws-cli"></a>

如果您要檢視已套用至特定 Auto Scaling 群組的標籤，可使用以下其中一個 API 命令：
+ [describe-tags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-tags.html) – 您可以提供 Auto Scaling 群組名稱，以檢視指定群組的標籤清單。

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

  以下是回應範例。

  ```
  {
      "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) – 您可以提供 Auto Scaling 群組名稱，以檢視指定群組的屬性，包括任何標籤。

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

  以下是回應範例。

  ```
  {
      "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"
                  }
              ],
              ...
          }
      ]
  }
  ```