eb tags - Amazon Elastic Beanstalk
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

eb tags

Description

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

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

Syntax

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

Options

这些选项都不是必需的。如果运行不带任何选项的 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 一般参考中的 Amazon Elastic Beanstalk 终端节点和配额

--resource ARN

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

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

Output

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

Examples

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