| « PreviousNext » | |
  | Did this page help you? Yes | No | Tell us about it... |
ec2-describe-availability-zones
Description
Describes one or more of the Availability Zones that are available to you. 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. Availability Zone assignments are mapped independently for each account.
The short version of this command is ec2daz.
Syntax
ec2-describe-availability-zones
[
zone_name ...]
[[--filter "name=value"] ...]
Options
| Name | Description |
|---|---|
|
|
One or more Availability Zone names. Type: String Default: Describes all zones in the region. Required: No Example: us-east-1a |
|
|
A filter for limiting the results. See the Supported Filters section for a list of supported filters. Use quotation marks if the value string has a space ("name=value example"). On a Windows system, use quotation marks even without a space in the value string ("name=value"). Type: String Default: Describes all zones in the region, or only those you specified by name. Required: No Example: --filter "region-name=ap-southeast-1" |
Supported Filters
You can specify filters so that the response includes information for only certain Availability Zones. For example, you can use a filter to specify that you're interested in Availability Zones in the available state. You can specify multiple values for a filter. The response includes information for an Availability Zone only if it matches at least one of the filter values that you specified.
You can specify multiple filters; for example, specify Availability Zones that are in a particular region and are in the available state. The response includes information for an Availability Zone only if it matches all the filters that you specified. If there's no match, no special message is returned, the response is simply empty.
You can use wildcards in a filter value. An asterisk (*) matches zero or more characters, and a question mark (?) 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 are the available filters.
messageInformation about the Availability Zone.
Type: String
region-nameThe region for the Availability Zone (for example, us-east-1).
Type: String
stateThe state of the Availability Zone
Type: String
Valid values:
availablezone-nameThe name of the zone.
Type: String
Common Options
| Option | Description |
|---|---|
|
|
Overrides the region specified by the Default: The value of the Example: |
|
|
The uniform resource locator (URL) of the Amazon EC2 web service entry point. Default: The value of the Example: |
|
|
The private key that identifies you to Amazon EC2. For more information, see Tell the Tools Who You Are. Default: The value of the Example: |
|
|
The X.509 certificate that identifies you to Amazon EC2. Default: The value of the Example: |
|
|
The access key ID associated with your AWS account. For more information, see Tell the Tools Who You Are. Default: The value of the Example: Note For more information, see the following section, Deprecated Options. |
|
|
The secret access key associated with your AWS account. Default: The value of the Example: Note For more information, see the following section, Deprecated Options. |
|
|
The AWS delegation token. Default: The value of the environment variable (if set). |
|
|
The connection timeout, in seconds. Example: |
|
|
The request timeout, in seconds. Example: |
|
|
Displays verbose output, including the API request and response on the command line. This is useful if you are building tools to talk directly to our Query API. |
|
|
Includes column headers in the command output. |
|
|
Shows empty columns as |
|
|
Omits tags for tagged resources. |
|
|
Displays internal debugging information. This can assist us when helping you troubleshooting problems. |
|
|
Displays usage information for the command. |
|
|
Reads arguments from standard input. This is useful when piping the output from one command to the input of another. Example: |
Deprecated Options
For a limited time, you can still use the private key and X.509 certificate instead of your access key ID and secret access key. However, we recommend that you start using your access key ID (-O, --aws-access-key) and secret access key (-W, --aws-secret-key) now, as the private key (-K, --private-key) and X.509 certificate (-C, --cert) won't be supported after the transition period elapses. For more information, see Tell the Tools Who You Are.
| Option | Description |
|---|---|
|
|
The private key to use when constructing requests to Amazon EC2. Default: The value of the Example: |
|
|
The X.509 certificate to use when constructing requests to Amazon EC2. Default: The value of the Example: |
Output
This command returns a table that contains the following information for each Availability Zones retrieved:
The AVAILABILITYZONE identifier
The name of the Availability Zone
The state of the zone
The region that the Availability Zone belongs to
Any messages associated with the Availability 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 response includes zones only for the region you're currently using.
PROMPT>>ec2-describe-availability-zonesAVAILABILITYZONE us-west-2a available us-west-2 AVAILABILITYZONE us-west-2b available us-west-2 AVAILABILITYZONE us-west-2c available us-west-2
Example Request
This example displays information about Availability Zones that are available
to the account in the us-east-1 region.
PROMPT>>ec2-describe-availability-zones --region us-east-1AVAILABILITYZONE us-east-1a available us-east-1 AVAILABILITYZONE us-east-1b available us-east-1 AVAILABILITYZONE us-east-1c available us-east-1 AVAILABILITYZONE us-east-1d available us-east-1
