Sign In to the Console
AWS Elastic Beanstalk
Developer Guide (API Version 2010-12-01)
AWS Documentation » AWS Elastic Beanstalk » Developer Guide » The Elastic Beanstalk Command Line Interface (EB CLI) » EB CLI Command Reference » eb tags
AWS services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon AWS.

eb tags

Description

Add, delete, update, and list Elastic Beanstalk environment tags.

For details about environment tagging, see Tagging Resources in Your Elastic Beanstalk Environment.

Syntax

eb tags [environment-name] -l|--list

eb tags [environment-name] -a|--add key1=value1[,key2=value2 ...]

eb tags [environment-name] -u|--update key1=value1[,key2=value2 ...]

eb tags [environment-name] -d|--delete key1[,key2 ...]

You can combine the --add, --update, and --delete subcommand options in a single command. At least one of them is required. You can't combined any of these three subcommand options with --list.

Environment names must be 4 to 40 characters in length, and can only contain letters, numbers, and hyphens. Environment names can't begin or end with a hyphen.

Options

None of these options are required. If you run eb create without any options, you are prompted to enter or select a value for each setting.

Name

Description

-l

or

--list

List all tags that are currently applied to the environment.

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

or

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

Apply new tags to the environment. Specify tags as a comma-separated list of key=value pairs. You can't specify keys of existing tags.

Valid values: See Tag an Environment.

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

or

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

Update the values of existing environment tags. Specify tags as a comma-separated list of key=value pairs. You must specify keys of existing tags.

Valid values: See Tag an Environment.

-d key1[,key2 ...]

or

--delete key1[,key2 ...]

Delete existing environment tags. Specify tags as a comma-separated list of keys. You must specify keys of existing tags.

Valid values: See Tag an Environment.

-r region

or

--region region

The AWS Region in which your environment is running.

Default: the configured default region.

For the list of values you can specify for this option, see AWS Elastic Beanstalk in Regions and Endpoints in the Amazon Web Services General Reference.

Output

The --list subcommand option displays a list of the environments tags. The output shows both the tags that Elastic Beanstalk applies by default and your custom tags. 

$ 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

The --add, --update, and --delete subcommand options, when successful, don't have any output. You can add the --verbose option to see detailed output of the command's activity. 

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

Key                                 Value

mytag                               tag value

Examples

The following command adds a tag with the key tag1 and the value value1, and at the same time deletes the tag tag2. 

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

The following command fails because it tries to update a nonexisting tag.

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

  tag3

The following command fails because it tries to update and delete the same key.

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