eb tags - Amazon Elastic Beanstalk
描述语法选项输出示例
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

eb tags

描述

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

有关在 Elastic Beanstalk 中标记资源的详细信息，请参阅标记 Elastic Beanstalk 应用程序资源。

语法

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）指定资源。

选项

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

名称

描述

-l

或

--list

列出当前应用于资源的所有标签。

-a key1=value1[,key2=value2 ...]

或

--add key1=value1[,key2=value2 ...]

将新标签应用到资源。将标签指定为逗号分隔的 key=value 对的列表。您无法指定现有标签的密钥。

有效值：请参阅为资源添加标签。

-u key1=value1[,key2=value2 ...]

或

--update key1=value1[,key2=value2 ...]

更新现有资源标签的值。将标签指定为逗号分隔的 key=value 对的列表。您必须指定现有标签的密钥。

有效值：请参阅为资源添加标签。

-d key1[,key2 ...]

或

--delete key1[,key2 ...]

删除现有资源标签。将标签指定为逗号分隔的密钥列表。您必须指定现有标签的密钥。

有效值：请参阅为资源添加标签。

-r region

或

--region region

您的资源所在的Amazon Web Services 区域区域。

默认值：配置的默认区域。

有关可以为此选项指定的值列表，请参阅 Amazon Web Services 一般参考 中的 Amazon Elastic Beanstalk 端点和配额。

--resource ARN

要使用命令修改或列出其标签的资源的 ARN。如果未指定，则命令引用当前目录的应用程序中的（默认或指定）环境。

有效值：请参阅特定于您感兴趣的资源的为资源添加标签子主题。这些主题介绍资源 ARN 的构造方式，并说明如何为您的应用程序或账户获取此资源存在的 ARN 的列表。

输出

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

示例

以下命令成功地将键为 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.