| Did this page help you? Yes No Tell us about it... |
Describes Regions that are currently available to the account.
You can use filters with this call just as you can with other "describe" calls.
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 |
|---|---|
|
|
Region's endpoint (e.g., ec2.us-east-1.amazonaws.com). Type: String |
|
|
Name of the Region. Type: String |
| Name | Description | Required |
|---|---|---|
|
|
One or more Region names. Type: String Default: Describes all Regions available to the account. |
No |
|
|
Name of a filter. See the preceding table for a list of allowed filter names. Type: String Default: None |
No |
|
|
A value for the filter. See the preceding table for a list of allowed values for each filter. Type: String Default: None |
No |
The elements in the following table are wrapped in a
DescribeRegionsResponse structure.
| Name | Description |
|---|---|
|
|
The ID of the request. Type: xsd:string |
|
|
List of Regions. Each Region's information is wrapped in an
Type: RegionItemType |
This example displays information about all Regions.
https://ec2.amazonaws.com/?Action=DescribeRegions &AUTHPARAMS
This example displays information about just the specified Regions.
https://ec2.amazonaws.com/?Action=DescribeRegions &RegionName.1=us-east-1 &RegionName.2=eu-west-1 &AUTHPARAMS
<DescribeRegionsResponse xmlns="http://ec2.amazonaws.com/doc/2011-05-15/">
<requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId>
<regionInfo>
<item>
<regionName>us-east-1</regionName>
<regionEndpoint>ec2.us-east-1.amazonaws.com</regionEndpoint>
</item>
<item>
<regionName>eu-west-1</regionName>
<regionEndpoint>ec2.eu-west-1.amazonaws.com</regionEndpoint>
</item>
</regionInfo>
</DescribeRegionsResponse>
This example displays information about all Regions that have the string ap in the endpoint.
https://ec2.amazonaws.com/?Action=DescribeRegions &Filter.1.Name=endpoint &Filter.1.Value.1=*ap* &AUTHPARAMS
<DescribeRegionsResponse xmlns="http://ec2.amazonaws.com/doc/2011-05-15/">
<requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId>
<regionInfo>
<item>
<regionName>ap-southeast-1</regionName>
<regionEndpoint>ec2.ap-southeast-1.amazonaws.com</regionEndpoint>
</item>
</regionInfo>
</DescribeRegionsResponse>