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

# 標記應用程式版本
<a name="applications-versions-tagging"></a>

本主題說明標記 Elastic Beanstalk 應用程式版本的好處，以及如何管理標籤。

您可以將標籤套用至 AWS Elastic Beanstalk 應用程式版本。標籤是與 AWS 資源相關聯的鍵/值對。如需 Elastic Beanstalk 資源標記、使用案例、標籤索引鍵和值限制條件的相關資訊，以及支援的資源類型，請參閱[標記 Elastic Beanstalk 應用程式資源](applications-tagging-resources.md)。

您可以在建立應用程式版本時指定標籤。您可以在現有的應用程式版本中新增或移除標籤，以及更新現有標籤的值。您最多可以為每個應用程式版本新增 50 個標籤。

## 在應用程式版本建立期間新增標籤
<a name="applications-versions-tagging.create"></a>

當您使用 Elastic Beanstalk 主控台[建立環境](environments-create-wizard.md)，並選擇上傳您的應用程式碼版本時，您可以指定要與新的應用程式版本建立關聯的標籤金鑰和值。

您也可以使用 Elastic Beanstalk 主控台[上傳應用程式版本](applications-versions.md)，無須立即在環境中使用。在上傳應用程式版本時，您可以指定標籤索引鍵和值。

使用 AWS CLI 或其他 API 型用戶端，在 **[create-application-version](https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/create-application-version.html)**命令上使用 `--tags` 參數來新增標籤。

```
$ aws elasticbeanstalk create-application-version \
      --tags Key=mytag1,Value=value1 Key=mytag2,Value=value2 \
      --application-name my-app --version-label v1
```

當您使用 EB CLI 來建立或更新環境時，系統會從您部署的程式碼建立應用程式版本。您無法在 EB CLI 建立應用程式版本期間直接標記應用程式版本。請參閱以下區段，了解如何將標籤新增至現有的應用程式版本。

## 管理現有應用程式版本的標籤
<a name="applications-versions-tagging.manage"></a>

您可以新增、更新和刪除現有 Elastic Beanstalk 應用程式版本中的標籤。

**若要使用 Elastic Beanstalk 主控台管理應用程式版本的標籤**

1. 開啟 [Elastic Beanstalk 主控台](https://console.aws.amazon.com/elasticbeanstalk)，然後在**區域**清單中選取您的 AWS 區域。

1. 在導覽窗格中，選擇 **Applications** (應用程式)，然後在清單上選取應用程式名稱。

1. 在導覽窗格中，找到應用程式名稱並選擇 **Application versions (應用程式版本)**。

1. 選取您要管理的應用程式版本。

1. 選擇 **Actions (動作)**，然後選擇 **Manage tags (管理標籤)**。

1. 使用畫面顯示表單來新增、更新或刪除標籤。

1. 若要儲存變更，請選擇頁面底部的**儲存變更**。

如果您使用 EB CLI 更新應用程式版本，請使用 **[eb tags](eb3-tags.md)** 新增、更新、刪除或列出標籤。

例如，以下命令會列出應用程式版本中的標籤。

```
~/workspace/my-app$ eb tags --list --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:applicationversion/my-app/my-version"
```

下列命令會更新標籤 `mytag1` 並刪除標籤 `mytag2`。

```
~/workspace/my-app$ eb tags --update mytag1=newvalue --delete mytag2 \
      --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:applicationversion/my-app/my-version"
```

如需完整選項清單和更多範例，請參閱 `eb tags`。

使用 AWS CLI 或其他 API 型用戶端時，請使用 **[list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/list-tags-for-resource.html)**命令來列出應用程式版本的標籤。

```
$ aws elasticbeanstalk list-tags-for-resource --resource-arn "arn:aws:elasticbeanstalk:us-east-2:my-account-id:applicationversion/my-app/my-version"
```

使用 **[update-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/update-tags-for-resource.html)** 命令新增、更新或刪除應用程式版本中的標籤。

```
$ aws elasticbeanstalk update-tags-for-resource \
      --tags-to-add Key=mytag1,Value=newvalue --tags-to-remove mytag2 \
      --resource-arn "arn:aws:elasticbeanstalk:us-east-2:my-account-id:applicationversion/my-app/my-version"
```

在 `--tags-to-add` 的 **update-tags-for-resource** 參數中，同時指定欲新增和欲更新的標籤。如此將新增不存在的標籤，並更新現有標籤的值。

**注意**  
若要搭配 Elastic Beanstalk 應用程式版本使用某些 EB CLI 和 AWS CLI 命令，您需要應用程式版本的 ARN。您可使用下列命令來擷取 ARN。  

```
$ aws elasticbeanstalk describe-application-versions --application-name my-app --version-label my-version
```