euca-describe-tags

Lists tags associated with your account.

Syntax

euca-describe-tags  [[--filter "name=value"] ...]

Options

Option Description Required
-F, --filter name=value Filter for limiting the results. See the table in the Available Filters section for a list of filters. Use quotation marks if the value has a space ("name=value example"). On a Windows system, use quotation marks even without a space in the value ("name=value"). No

Available Filters

You can add filters to your request so that the response includes information for only certain tags. For example, you can use a filter to specify that you want to find tags for a specific resource type. Some tips for using filters with this command:

The following are the available filters for euca-describe-volumes:

Filter Description
key Tag key
resource-id ID of the resource
resource-type Resource type.

Valid values: customer-gateway | dhcp-options | image | instance | reserved-instances | snapshot | spot-instances-request | subnet | volume | vpc | vpn-connection | vpn-gateway

value Tag value

Common Options

Option Description
--show-empty-fields Show empty fields as "(nil)".
--region user@region Region and/or user name to search when looking up config file data. Only valid for EC2 endpoints.
-U,--url url URL of the cloud service to connect to. For administrative commands, this should be <ip_address>:8773/services/Empyrean.
-I,--access-key-id key_id User's access key ID.
-S,--secret-key secret_key User's secret key.
--security-token token User's security token.
--debug Prints what the command sends to the server and what it receives from the server. Use when you're trying to debug Euca2ools.
--debugger Enable interactive debugger on error.
-h,--help Display the manual page for the command.
--version Display the version of this tool.

Output

Examples

The following example describes all your tags.

euca-describe-tags
TAG  emi-1a2b3c4d  image  appserver
TAG  emi-1a2b3c4d  image  stack  dev
TAG  i-5f4e3d2a  instance  appserver
TAG  i-5f4e3d2a  instance  stack  dev
TAG  i-12345678  instance  database_server
TAG  i-12345678  instance  stack  test

The following example describes the tags for a resource with ID emi-1a2b3c4d.

euca-describe-tags --filter "resource-id=emi-1a2b3c4d"
TAG  emi-1a2b3c4d  image  appserver
TAG  emi-1a2b3c4d  image  stack  dev

The following example describes the tags for all your instances.

euca-describe-tags --filter "resource-type=instance"
TAG  i-5f4e3d2a  instance  appserver
TAG  i-5f4e3d2a  instance  stack  dev
TAG  i-12345678  instance  database_server
TAG  i-12345678  instance  stack  test

The following example describes the tags for all your instances that have a tag with the key appserver.

ec2-describe-tags --filter "resource-type=instance" --filter "key=appserver"
TAG  i-5f4e3d2a  instance  appserver

The following example describes the tags for all your instances that have a tag with the key stack and a value of either dev or test.

euca-describe-tags --filter "resource-type=instance" --filter "key=stack" --filter
  			"value=dev" --filter "value=test"
TAG  i-5f4e3d2a  instance  stack  test
TAG  i-12345678  instance  stack  dev
x