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: DescribeRegionsResponse
Children: None
regionInfo
Region set.
Type: RegionSetType
Ancestor: DescribeRegionsResponse
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-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>