ECLAT-LSTAG

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

SEE ALSO

eclat(1), eclat−mktag(1), eclat−rmtag(1).

AUTHORS

Sergey Poznyakoff

BUG REPORTS

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

COPYRIGHT

Copyright © 2012-2015 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.