.\" This file is part of Eclat -*- nroff -*-
.\" Copyright (C) 2012-2014 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 LSZON 1 "February 13, 2014" "ECLAT" "Eclat User Reference"
.SH NAME
eclat lszon, describe\-availability\-zones \- describe availability zones
.SH SYNOPSIS
\fBeclat lszon\fR [\fIFILTER\fR...] [\fIZONE\fR...]
.PP
\fBeclat lszon\fR \fB\-\-help\fR
.SH DESCRIPTION
This command lists availability zones accessible to your account. The
results include zones only for the region you're currently using, as
set by the
.B default-region
configuration file statement or the
.B \-\-region
command line option.
.PP
If no arguments are given, the command will list all availability
zones.  Otherwise, it will list only zones with the supplied names.
.SH FILTERS
Filters allow you to select only zones matching particular
criteria.  The following filters are defined:
.TP
\fBmessage\fR=\fIstring\fR
Information about the Availability Zone.
.TP
\fBregion\-name\fR=\fIstring\fR
The region the Availablity Zone is in.  The purpose of this filter
is highly questionable, because you can describe only zones in the
currently selected region anyway.  It is, however, included in the AWS
API, so we list it here for completeness sake.
.TP
\fBstate\fR=\fBavailable\fR
Show only available zones.
.TP
\fBzone\-name\fR=\fBstring\fR
Select zone with the given name.  It is the same as giving
\fBstring\fR as a command line argument.
.SH OUTPUT
The default output shows at least one line for each zone.  Each such
line contains zone name and its status, separated by a single tab
character.
.PP
If there are any messages associated with the zone, these are printed
in subsequent lines.  Each message is indented one tab stop.
.SH EXAMPLE
.PP
.EX
$ eclat lszon
eu-west-1a      available
eu-west-1b      available
eu-west-1c      available
.EE
.SH "SEE ALSO"
.BR eclat (1),
.BR eclat\-lsreg (1).
.SH AUTHORS
Sergey Poznyakoff
.SH "BUG REPORTS"
Report bugs to <bug\-eclat@gnu.org.ua>.
.SH COPYRIGHT
Copyright \(co 2012-2014 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: