本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在您的 Elastic Beanstalk 環境中標記資源
您可以將標籤套用至您的 AWS Elastic Beanstalk 環境。標籤是與 AWS 資源相關聯的鍵/值對。如需 Elastic Beanstalk 資源標記、使用案例、標籤索引鍵和值限制條件的相關資訊，以及支援的資源類型，請參閱[標記 Elastic Beanstalk 應用程式資源](applications-tagging-resources.md)。
Elastic Beanstalk 會將環境標籤套用至環境資源本身，以及 Elastic Beanstalk 為環境建立的其他 AWS 資源。您也可以使用標記來管理環境中特定資源層級的許可。如需詳細資訊，請參閱《[Amazon EC2 使用者指南》中的標記您的](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html) *Amazon EC2 *資源。
依預設，Elastic Beanstalk 會將幾個標籤套用至您的環境：
+ `elasticbeanstalk:environment-name` - 環境名稱。
+ `elasticbeanstalk:environment-id` - 環境 ID。
+ `Name` – 亦為環境名稱。在 Amazon EC2 儀表板上，`Name` 用於辨識並排序資源。
您無法編輯這些預設標籤。
您可以在建立 Elastic Beanstalk 環境時指定標籤。在現有環境中，您可以新增或移除標籤，並更新現有標籤的值。一個環境最多可以有 50 個標籤，包括預設標籤。
## 在環境建立期間新增標籤
使用 Elastic Beanstalk 主控台來建立環境時，您可於 [Create New Environment wizard](environments-create-wizard.md) (建立新環境精靈) 的 **Modify tags** (修改標籤) 頁面，以指定標籤索引鍵和值。
若您使用 EB CLI 來建立環境，請使用帶有 **[eb create](eb3-create.md)** 的 `--tags` 選項來新增標籤。
```
~/workspace/my-app$ eb create --tags {{mytag1}}={{value1}},{{mytag2}}={{value2}}
```
使用 AWS CLI 或其他 API 型用戶端時，請在 **[create-environment](https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/create-environment.html)**命令上使用 `--tags` 參數。
```
$ aws elasticbeanstalk create-environment \
--tags Key={{mytag1}},Value={{value1}} Key={{mytag2}},Value={{value2}} \
--application-name {{my-app}} --environment-name {{my-env}} --cname-prefix {{my-app}} --version-label {{v1}} --template-name {{my-saved-config}}
```
[已儲存組態](environment-configuration-methods-before.md#configuration-options-before-savedconfig)包含使用者定義的標記。當您於環境建立期間套用內含標籤的已儲存組態，只要您尚未指定任何新標籤，這些標籤將套用至新環境。若您使用上述方法將標籤新增至環境，將會捨棄已儲存組態內定義的任何標籤。
## 管理現有環境的標籤
您可以在現有的 Elastic Beanstalk 環境中新增、更新和刪除標籤。Elastic Beanstalk 會將變更套用至您環境的資源。
但是，您無法編輯 Elastic Beanstalk 套用至您環境的預設標籤。
**在 Elastic Beanstalk 主控台中管理環境的標籤**
1. 開啟 [Elastic Beanstalk 主控台](https://console.aws.amazon.com/elasticbeanstalk)，然後在**區域**清單中選取您的 AWS 區域。
1. 在導覽窗格中，選擇**環境**，然後在清單中選擇您環境的名稱。
1. 在導覽窗格中，選擇 **Tags (標籤)**。
標籤管理頁面會顯示環境中現有的標籤清單。
1. 新增、更新或刪除標籤：
+ 若要新增標籤，請於清單底部的空白方塊中輸入標籤。若要新增其他標籤，請選擇 **Add tag (新增標籤)**，然後 Elastic Beanstalk 會新增另一對空白方塊。
+ 欲更新標籤的金鑰或值，請於標籤列各自的方塊進行編輯。
+ 若要刪除標籤，請選擇標籤值方塊旁邊的 **Remove (移除)**。
1. 若要儲存變更，請選擇頁面底部的**儲存變更**。
若您透過 EB CLI 更新環境，請使用 **[eb tags](eb3-tags.md)** 來新增、更新、刪除或列出標籤。
例如，下列命令會列出您預設環境的標籤。
```
~/workspace/my-app$ eb tags --list
```
下列命令會更新標籤 `mytag1` 並刪除標籤 `mytag2`。
```
~/workspace/my-app$ eb tags --update {{mytag1}}={{newvalue}} --delete {{mytag2}}
```
如需完整選項清單和更多範例，請參閱 `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}}:environment/{{my-app}}/{{my-env}}"
```
使用 **[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}}:environment/{{my-app}}/{{my-env}}"
```
在 `--tags-to-add` 的 **update-tags-for-resource** 參數中，同時指定欲新增和欲更新的標籤。如此將新增不存在的標籤，並更新現有標籤的值。
**注意**
若要搭配 Elastic Beanstalk 環境使用這兩個 AWS CLI 命令，您需要環境的 ARN。您可使用下列命令來擷取 ARN。
```
$ aws elasticbeanstalk describe-environments
```