DescribeRegions
Description
Describes regions that are currently available to the account.
Request Parameters
| Name | Description | Required |
|---|---|---|
|
Type: |
Ancestor: None
Children: regionSet
regionSet
Set of regions.
Type: DescribeRegionsSetType
Ancestor: DescribeRegions
Children: item
item
Information for a region.
Type: DescribeRegionsSetItemType
Ancestor: regionSet
Children: region
region
Name of a region.
Type: xsd:string
Default: Describes all regions available to the account.
Ancestor: item
Children: None
No
Response Elements
| Name | Description |
|---|---|
|
|
Type: DescribeRegionsResponse Ancestor: None Children: |
|
The ID of the request. Type: xsd:string Ancestor: Children: None |
|
Region set. Type: RegionSetType Ancestor: Children: |
|
Information for a region. Type: RegionItemType Ancestor: Children: |
|
Name of the region. Type: xsd:string Ancestor: Children: None |
|
Region service endpoint. Type: xsd:string Ancestor: Children: None |
Examples
Example Request
This example displays regions that are available to the account.
<DescribeRegions xmlns="http://ec2.amazonaws.com/doc/2009-04-04/"> <regionSet/> </DescribeRegions>
Example Response
<DescribeRegionsResponse xmlns="http://ec2.amazonaws.com/doc/2009-04-04/">
<regionInfo>
<item>
<regionName>us-east-1</regionName>
<regionEndpoint>us-east-1.ec2.amazonaws.com</regionEndpoint>
</item>
<item>
<regionName>eu-west-1</regionName>
<regionUrl>eu-west-1.ec2.amazonaws.com</regionUrl>
</item>
</regionInfo>
</DescribeRegionsResponse>