ec2-describe-availability-zones

Description

Displays Availability Zones that are currently available to the account. The results include zones only for the Region you're currently using.

	Note
	Availability Zones are not the same across accounts. The Availability Zone us-east-1a for account A is not necessarily the same as us-east-1a for account B. Zone assignments are mapped independently for each account.

You can filter the results to return information only about zones that match criteria you specify. For example, you could filter the results to return only the zones whose state is available. You can specify multiple filters (e.g., the zone is in a particular Region, and the state is available). The result includes information for a particular zone only if it matches all your filters. If there's no match, no special message is returned; the response is simply empty.

You can use wildcards with the filter values: * matches zero or more characters, and ? matches exactly one character. You can escape special characters using a backslash before the character. For example, a value of \*amazon\?\\ searches for the literal string *amazon?\.

The following table shows the available filters.

Filter Name	Description
`message`	Message giving information about the Availability Zone. Type: String
`region-name`	Region the Availablity Zone is in (e.g., us-east-1). Type: String
`state`	State of the Availability Zone Type: String Valid Values: `available`
`zone-name`	Name of the zone. Type: String

The short version of this command is ec2daz.

Syntax

ec2-describe-availability-zones [zone_name ...] [[--filter name=value] ...]

Options

Name Description Required

Name	Description	Required
`zone_name`	Availability Zone name. Type: String Default: Shows all zones in the Region. Example: us-east-1a	No
`--filter` `name`=`value`	A filter for limiting the results. See the preceding table for a list of allowed filter names and values. If you're using the command line tools on a Windows system, you might need to use quotation marks (i.e., "name=value"). Type: String Default: Shows all zones in the Region, or only the ones you've otherwise specified. Example: --filter "region-name=ap-southeast-1"	No

zone_name

Availability Zone name.

Type: String

Default: Shows all zones in the Region.

Example: us-east-1a

No

--filter name=value

A filter for limiting the results. See the preceding table for a list of allowed filter names and values. If you're using the command line tools on a Windows system, you might need to use quotation marks (i.e., "name=value").

Type: String

Default: Shows all zones in the Region, or only the ones you've otherwise specified.

Example: --filter "region-name=ap-southeast-1"

No

Common Options

Option	Description
`--region` `REGION`	Overrides the Region specified in the `EC2_URL` environment variable and the URL specified by the `-U` option. Default: The `EC2_URL` environment variable, or `us-east-1` if the environment variable is not set. Example: `--region eu-west-1`
`-U, --url` `URL`	`URL` is the uniform resource locator of the Amazon EC2 web service entry point. Default: The `EC2_URL` environment variable, or https://ec2.amazonaws.com if the environment variable is not set. Example: `-U https://ec2.amazonaws.com`
`-K, --private-key` `EC2-PRIVATE-KEY`	The private key to use when constructing requests to Amazon EC2. Default: The value of the `EC2_PRIVATE_KEY` environment variable. Example: `-K pk-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem`
`-C, --cert` `EC2-CERT`	The X.509 certificate to use when constructing requests to Amazon EC2. Default: The value of the `EC2_CERT` environment variable. Example: `-C cert-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem`
`--connection-timeout` `TIMEOUT`	Specifies a connection timeout (in seconds). Example: --connection-timeout 30
`--request-timeout` `TIMEOUT`	Specifies a request timeout (in seconds). Example: --request-timeout 45
`-v, --verbose`	Displays verbose output by showing the SOAP request and response on the command line. This is particularly useful if you are building tools to talk directly to our SOAP API.
`-H, --headers`	Displays column headers in the output.
`--show-empty-fields`	Shows empty columns as `(nil)`.
`--hide-tags`	Do not display tags for tagged resources.
`--debug`	Prints internal debugging information. This is useful to assist us when troubleshooting problems.
`-?, --help, -h`	Displays Help.
`-`	If `-` is specified as an argument to one of the parameters, a list of arguments is read from standard input. This is useful for piping the output of one command into the input of another. Example: `ec2-describe-instances \| grep stopped \| cut -f 2 \| ec2-start-instances -`

Output

The command returns a table that contains the following information:

AVAILABILITYZONE identifier
Availability Zone name
State of the zone

Amazon EC2 command line tools display errors on stderr.

Examples

Example Request

This example displays information about Availability Zones that are available to the account. The results include zones only for the Region you're currently using.

PROMPT> ec2-describe-availability-zones
AVAILABILITYZONE us-east-1a available
AVAILABILITYZONE us-east-1b available
AVAILABILITYZONE us-east-1c available
AVAILABILITYZONE us-east-1d available