aboutsummaryrefslogtreecommitdiff
path: root/doc/eclat-describe-tags.1
blob: 85288e5db8b3603d7fe924e49d49099bcb96df85 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
.\" This file is part of Eclat -*- nroff -*-
.\" Copyright (C) 2012, 2013 Sergey Poznyakoff
.\"
.\" Eclat is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 3, or (at your option)
.\" any later version.
.\"
.\" Eclat is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with Eclat.  If not, see <http://www.gnu.org/licenses/>.
.TH DESCRIBE\-TAGS 1 "January 19, 2013" "ECLAT" "Eclat User Reference"
.SH NAME
eclat describe\-tags \- list the EC2 tags 
.SH SYNOPSIS
eclat describe\-tags [\fBFILTER\fR...]

eclat describe\-tags \fB\-\-help\fR
.SH DESCRIPTION
This command lists the EC2 tags.  If no filter has been supplied, all
tags are listed.  
.SH FILTERS
Available filters are:
.TP
\fBkey\fR=\fIstring\fR
Lists tags with the given key.
.TP
\fBresource\-id\fR=\fIstring\fR[,\fIstring\fR...]
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 
.B MAPS
section in
.BR 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:
.sp
.nf
.in +2
eclat \-x describe\-tags resource\-id=InstanceId:webserver
.in
.fi
.sp
.TP
\fBresource\-type\fR=\fItype\fR.
List only tags pertaining to resources of the given \fItype\fR.  Valid
\fItype\fRs are: \fBcustomer-gateway\fR, \fBdhcp-options\fR,
\fBimage\fR, \fBinstance\fR, \fBinternet-gateway\fR, \fBnetwork-acl\fR,
\fBreserved-instances\fR, \fBroute-table\fR, \fBsecurity-group\fR,
\fBsnapshot\fR, \fBspot-instances-request\fR, \fBsubnet\fR,
\fBvolume\fR, \fBvpc\fR, \fBvpn-connection\fR, and \fBvpn-gateway\fR.
.TP
\fBvalue\fR
Lists tags with the given value.
.SH OUTPUT
The default output format lists on each line the resource ID, its
type, the tag name and its value.  For example:
.sp
.nf
.in +2
ami-1a2b3c4d	image	webserver	
ami-1a2b3c4d	image	stack	Production
i-5f4e3d2a	instance	webserver	
i-5f4e3d2a	instance	stack	Production
i-12345678	instance	database_server	
.in
.fi
.SH EXAMPLE
.sp
.nf
.in +2
eclat describe\-tags resource-id=i-5f4e3d2a key=Name
.in
.fi
.SH "SEE ALSO"
.BR eclat (1),
.BR eclat\-create\-tags (1),
.BR eclat\-delete\-tags (1).
.SH AUTHORS
Sergey Poznyakoff
.SH "BUG REPORTS"
Report bugs to <bug\-eclat@gnu.org.ua>.
.SH COPYRIGHT
Copyright \(co 2012, 2013 Sergey Poznyakoff
.br
.na
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
.br
.ad
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.\" Local variables:
.\" eval: (add-hook 'write-file-hooks 'time-stamp)
.\" time-stamp-start: ".TH [A-Z_][A-Z0-9_.\\-]* [0-9] \""
.\" time-stamp-format: "%:B %:d, %:y"
.\" time-stamp-end: "\""
.\" time-stamp-line-limit: 20
.\" end:

Return to:

Send suggestions and report system problems to the System administrator.