本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# **eb tags**
<a name="eb3-tags"></a>

## 说明
<a name="eb3-tagsdescription"></a>

添加、删除、更新和列出 Elastic Beanstalk 资源的标签。

有关在 Elastic Beanstalk 中标记资源的详细信息，请参阅[标记 Elastic Beanstalk 应用程序资源](applications-tagging-resources.md)。

## 语法
<a name="eb3-tagsyntax"></a>

**eb tags [{{environment-name}}] [--resource {{ARN}}] -l \| --list**

**eb tags [{{environment-name}}] [--resource {{ARN}}] -a \| --add {{key1}}={{value1}}[,{{key2}}={{value2}} ...]**

**eb tags [{{environment-name}}] [--resource {{ARN}}] -u \| --update {{key1}}={{value1}}[,{{key2}}={{value2}} ...]**

**eb tags [{{environment-name}}] [--resource {{ARN}}] -d \| --delete {{key1}}[,{{key2}} ...]**

您可以将 `--add`、`--update` 和 `--delete` 子命令选项组合在单个命令中。至少需要其中一个选项。这三个子命令选项中的任何一个都不能与 `--list` 结合使用。

不指定任何其他参数时，所有上述命令都将列出或修改当前目录的应用程序中默认环境的标签。使用{{environment-name}}参数，命令会列出或修改该环境的标签。使用 `--resource` 选项时，命令将列出或修改任何 Elastic Beanstalk 资源的标签 - 应用程序、环境、应用程序版本、保存的配置或自定义平台版本。通过 Amazon Resource Name（ARN）指定资源。

## 选项
<a name="eb3-tagsoptions"></a>

这些选项都不是必需的。如果运行不带任何选项的 **eb create**，则系统会提示您为每个设置输入或选择值。


****  

|  名称  |  描述  | 
| --- | --- | 
| `-l`<br />或<br />`--list` | 列出当前应用于资源的所有标签。 | 
| `-a {{key1}}={{value1}}[,{{key2}}={{value2}} ...]`<br />或<br />`--add {{key1}}={{value1}}[,{{key2}}={{value2}} ...]` | 将新标签应用到资源。将标签指定为逗号分隔的 `key=value` 对的列表。您无法指定现有标签的密钥。<br />有效值：请参阅[标注资源](applications-tagging-resources.md)。 | 
| `-u {{key1}}={{value1}}[,{{key2}}={{value2}} ...]`<br />或<br />`--update {{key1}}={{value1}}[,{{key2}}={{value2}} ...]` | 更新现有资源标签的值。将标签指定为逗号分隔的 `key=value` 对的列表。您必须指定现有标签的密钥。<br />有效值：请参阅[标注资源](applications-tagging-resources.md)。 | 
| `-d {{key1}}[,{{key2}} ...]`<br />或<br />`--delete {{key1}}[,{{key2}} ...]` | 删除现有资源标签。将标签指定为逗号分隔的密钥列表。您必须指定现有标签的密钥。<br />有效值：请参阅[标注资源](applications-tagging-resources.md)。 | 
| `-r` {{region}}<br />或者<br />`--region` {{region}} | 您的资源 Amazon Web Services 区域 所在的。<br />默认值：配置的默认区域。<br />有关可以为此选项指定的值列表，请参阅 *Amazon Web Services 一般参考* 中的 [Amazon Elastic Beanstalk 端点和配额](https://docs.amazonaws.cn/general/latest/gr/elasticbeanstalk.html)。 | 
| `--resource {{ARN}}` | 要使用命令修改或列出其标签的资源的 ARN。如果未指定，则命令引用当前目录的应用程序中的（默认或指定）环境。<br />有效值：请参阅特定于您感兴趣的资源的[标注资源](applications-tagging-resources.md)子主题。这些主题展示了资源的 ARN 是如何构造的，并说明了如何获取您的应用程序或账户中 ARNs 存在的此资源的列表。 | 

## Output
<a name="eb3-tagsoutput"></a>

`--list` 子命令选项可显示资源标签的列表。输出既显示 Elastic Beanstalk 在默认情况下应用的标签，又显示您的自定义标签。

```
$ eb tags --list
Showing tags for environment 'MyApp-env':

Key                                 Value

Name                                MyApp-env
elasticbeanstalk:environment-id     e-63cmxwjaut
elasticbeanstalk:environment-name   MyApp-env
mytag                               tagvalue
tag2                                2nd value
```

`--add`、`--update` 和 `--delete` 子命令选项成功时没有任何输出。您可以通过添加 `--verbose` 选项来以查看命令活动的详细输出。

```
$ eb tags --verbose --update "mytag=tag value"
Updated Tags:

Key                                 Value

mytag                               tag value
```

## 示例
<a name="eb3-tagsexamples"></a>

以下命令成功地将键为 `tag1`、值为 `value1` 的标签添加到应用程序的默认环​​境中，同时删除标签 `tag2`。

```
$ eb tags --add tag1=value1 --delete tag2
```

以下命令成功地将标签添加到应用程序中的保存的配置。

```
$ eb tags --add tag1=value1 \
      --resource "arn:aws:elasticbeanstalk:us-east-2:{{my-account-id}}:configurationtemplate/{{my-app}}/{{my-template}}"
```

以下命令失败，因为它尝试更新不存在的标签。

```
$ eb tags --update tag3=newval
ERROR: Tags with the following keys can't be updated because they don't exist:

  tag3
```

以下命令失败，因为它尝试更新和删除同一密钥。

```
$ eb tags --update mytag=newval --delete mytag
ERROR: A tag with the key 'mytag' is specified for both '--delete' and '--update'. Each tag can be either deleted or updated in a single operation.
```