NAME

eclat-lstag, eclat-describe-tags - list the EC2 tags

SYNOPSIS

eclat lstag [-a ID] [-i ID] [-r [MAP:]ID] [-s ID] [-v ID] [-T FILE] [--ami ID] [--instance ID] [--resource-id [MAP:]ID] [--volume ID] [--snapshot ID] [FILTER...]

eclat lstag --help

DESCRIPTION

This command lists the EC2 tags. If no filter has been supplied, all tags are listed.

OPTIONS

-a, --ami ID: Describes tags of the given image. In resource translation mode, uses the map ImageId.
-i, --instance ID: Describes tags of the given instance. In resource translation mode, uses the map InstanceId.
-r, --resource-id [MAP:]ID: Describes tags of the EC2 resource identified by ID. If optional MAP prefix is supplied and resource translation mode is enabled, this option will use the MAP to translate ID into AWS resource identifier.
-s, --snapshot ID: Describes tags of the given snapshot. In resource translation mode, uses the map SnapshotId.
-v, --volume ID: Describes tags of the given volume. In resource translation mode, uses the map VolumeId.

FILTERS

Available filters are:

key=string

Lists tags with the given key.

resource-id=string[,string...]

Lists tags pertaining to the given resorce ID or IDs. Multiple IDs are allowed, provided that they are separated by commas. If ID mapping is requested (see the MAPS section in eclat(1)), each ID can be prefixed with the map name and a colon in order to request its translation using this map. For example:

eclat -x lstag resource-id=InstanceId:webserver

resource-type=type

List only tags pertaining to resources of the given type. Valid types are: customer-gateway, dhcp-options, image, instance, internet-gateway, network-acl, reserved-instances, route-table, security-group, snapshot, spot-instances-request, subnet, volume, vpc, vpn-connection, and vpn-gateway.

value=string

Lists tags with the given value.

OUTPUT

The default output format lists on each line the resource ID, its type, the tag name and its value. For example:

ami-1a2b3c4d	image	webserver	
ami-1a2b3c4d	image	stack	Production
i-5f4e3d2a	instance	webserver	
i-5f4e3d2a	instance	stack	Production
i-12345678	instance	database_server

EXAMPLE

eclat lstag resource-id=i-5f4e3d2a key=Name

AUTHORS

Sergey Poznyakoff

BUG REPORTS

Report bugs to <bug-eclat@gnu.org.ua>.

COPYRIGHT

Copyright © 2012-2018 Sergey Poznyakoff
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.