本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 在 Elastic Beanstalk 环境中标记资源
您可以将标签应用于您的 Amazon Elastic Beanstalk 环境。标签是与资源关联的键值对。 Amazon 有关 Elastic Beanstalk 资源标记、使用案例、标签键和值约束以及支持的资源类型的信息，请参阅[标记 Elastic Beanstalk 应用程序资源](applications-tagging-resources.md)。
Elastic Beanstalk 将环境标签应用于环境资源本身，以及 Elastic Beanstalk 为环境创建的其他 Amazon 资源。您可以使用标签管理某个环境内的特定资源级权限。有关更多信息，请参阅《亚马逊* EC2 用户指南》中的为您的亚马逊 EC2 *[资源添加标签](https://docs.amazonaws.cn/AWSEC2/latest/UserGuide/Using_Tags.html)。
默认情况下，Elastic Beanstalk 会将几个标签应用于您的环境：
+ `elasticbeanstalk:environment-name` – 环境名称。
+ `elasticbeanstalk:environment-id` – 环境 ID。
+ `Name`— 也是环境的名称。 `Name`在 Amazon EC2 控制面板中用于识别和分类资源。
您不能编辑这些默认标签。
您可以在创建 Elastic Beanstalk 环境时指定标签。在现有环境中，您可以添加或删除标签，以及更新现有标签的值。一个环境最多可以有 50 个标签，包括默认标签。
## 在创建环境期间添加标签
在使用 Elastic Beanstalk 控制台创建环境时，可以在[创建新环境向导](environments-create-wizard.md)的**修改标签**配置页面上指定标签键和值。
如果使用 EB CLI 创建环境，则可以使用 **[eb create](eb3-create.md)** 的 `--tags` 选项添加标签。
```
~/workspace/my-app$ eb create --tags {{mytag1}}={{value1}},{{mytag2}}={{value2}}
```
对于 Amazon CLI 或其他基于 API 的客户端，请使用命令中的`--tags`参数。**[create-environment](https://docs.amazonaws.cn/cli/latest/reference/elasticbeanstalk/create-environment.html)**
```
$ 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.amazonaws.cn/elasticbeanstalk) 控制台，然后**在 “区域” 列表中，选择您**的。 Amazon Web Services 区域
1. 在导航窗格中，选择 **Environments**（环境），然后从列表中选择环境的名称。
1. 在导航窗格中，选择 **Tags**。
标签管理页会显示环境中当前存在的标签的列表。
1. 添加、更新或删除标签：
+ 要添加标签，请将其输入列表底部的空白框中。要添加另一个标签，请选择**添加标签**，Elastic Beanstalk 将添加另一对空白框。
+ 要更新标签的键或值，请编辑标签行中的相应框。
+ 要删除标签，请选择标签的值框旁边的 **Remove (删除)**。
1. 要保存更改，请选择页面底部的 **Apply**（应用）。
如果使用 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`。
对于 Amazon CLI 或其他基于 API 的客户端，使用**[list-tags-for-resource](https://docs.amazonaws.cn/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.amazonaws.cn/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 环境中使用这两个 Amazon CLI 命令，你需要环境的 ARN。您可以使用下面的命令检索该 ARN。
```
$ aws elasticbeanstalk describe-environments
```