DescribeRegions
Description
Describes regions that are currently available to the account.
Request Parameters
| Name | Description | Required |
|---|---|---|
| Name of a region. Type: String Default: Describes all regions available to the account. | No |
Response Elements
| Name | Description |
|---|---|
|
Type: |
Ancestor: None
Children: requestId, regionInfo
requestId
The ID of the request.
Type: xsd:string
Ancestor: DescribeRegionsResponseType
Children: None
regionInfo
Region set.
Type: RegionSetType
Ancestor: DescribeRegionsResponseType
Children: item
item
Information for a region.
Type: RegionItemType
Ancestor: regionInfo
Children: regionName, regionEndpoint
regionName
Name of the region.
Type: xsd:string
Ancestor: item
Children: None
regionEndpoint
Region service endpoint.
Type: xsd:string
Ancestor: item
Children: None
Examples
Example Request
This example displays regions that are available to the account.
https://ec2.amazonaws.com/?Action=DescribeRegions&RegionName.0=us-east-1&RegionName.1=eu-west-1&AuthParams
Example Response
<DescribeRegionsResponse xmlns="http://ec2.amazonaws.com/doc/2009-08-15/">
<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>