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-10-31/">
<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>