DescribeAvailabilityZones

Amazon Elastic Compute Cloud: 2009-08-15

previous page next page

DescribeAvailabilityZones

Description

Displays Availability Zones that are currently available to the account and their states.

[Note]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.

Request Parameters

NameDescriptionRequired

ZoneName

Availability Zone name.

Type: String

Default: None

No

Response Elements

NameDescription

DescribeAvailabilityZonesResponseType

DescribeAvailabilityZonesResponseType element.

Type:

DescribeAvailabilityZonesResponseType

Ancestor: None

Children: requestId, availabilityZoneInfo

requestId

The ID of the request.

Type: xsd:string

Ancestor: DescribeAvailabilityZonesResponseType

Children: None

availabilityZoneInfo

Availability Zone information.

Type: AvailabilityZoneSetType

Ancestor: DescribeAvailabilityZonesResponseType

Children: item

item

Information for one Availability Zone.

Type: AvailabilityZoneItemType

Ancestor: availabilityZoneInfo

Children: zoneName, zoneState, regionName, and messageSet

zoneName

Name of the Availability Zone.

Type: xsd:string

Ancestor: item

Children: None

zoneState

State of the Availability Zone.

Type: xsd:string

Valid Values: available

Ancestor: item

Children: None

regionName

Name of the region.

Type: xsd:string

Ancestor: item

Children: None

messageSet

Message set.

Type: AvailabilityZoneMessageSetType

Ancestor: item

Children: item

item

Availability Zone message set.

Type: AvailabilityZoneMessageType

Ancestor: messageSet

Children: message

message

The Availability Zone message.

Type: xsd:string

Ancestor: item

Children: None

Examples

Example Request

This example displays information about Availability Zones that are available to the account.

https://ec2.amazonaws.com/?Action=DescribeAvailabilityZones&ZoneName.0=us-east-1a&ZoneName.1=us-east-1b&ZoneName.2=us-east-1c&ZoneName.3=us-east-1d&AuthParams

Example Response

<DescribeAvailabilityZonesResponse xmlns="http://ec2.amazonaws.com/doc/2009-08-15/">
  <availabilityZoneInfo>
    <item>
      <zoneName>us-east-1a</zoneName>
      <zoneState>available</zoneState>
    </item>
    <item>
      <zoneName>us-east-1b</zoneName>
      <zoneState>available</zoneState>
    </item>
    <item>
      <zoneName>us-east-1c</zoneName>
      <zoneState>available</zoneState>
    </item>
    <item>
      <zoneName>us-east-1d</zoneName>
      <zoneState>available</zoneState>
    </item>
  </availabilityZoneInfo>
</DescribeAvailabilityZonesResponse>
previous page start next page