Euca2ools Guide / EC2-Compatible Commands |
Lists tags associated with your account.
euca-describe-tags [[--filter "name=value"] ...]
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 |
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 |
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. |
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