com.amazonaws.regions
Class RegionUtils

java.lang.Object
  extended by com.amazonaws.regions.RegionUtils

public class RegionUtils
extends java.lang.Object

Utilities for working with regions.


Constructor Summary
RegionUtils()
           
 
Method Summary
static Region getRegion(java.lang.String regionName)
          Returns the region with the id given, if it exists.
static Region getRegionByEndpoint(java.lang.String endpoint)
          Searches through all known regions to find one with any service at the specified endpoint.
static java.util.List<Region> getRegions()
          Returns a list of the available AWS regions.
static java.util.List<Region> getRegionsForService(java.lang.String serviceAbbreviation)
          Returns a list of the regions that support the service given.
static void init()
          Fetches the most recent version of the regions file from the remote source and caches it to the workspace metadata directory, then initializes the static list of regions with it.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

RegionUtils

public RegionUtils()
Method Detail

getRegions

public static java.util.List<Region> getRegions()
Returns a list of the available AWS regions.


getRegionsForService

public static java.util.List<Region> getRegionsForService(java.lang.String serviceAbbreviation)
Returns a list of the regions that support the service given.

See Also:
ServiceAbbreviations

getRegion

public static Region getRegion(java.lang.String regionName)
Returns the region with the id given, if it exists. Otherwise, returns null.


getRegionByEndpoint

public static Region getRegionByEndpoint(java.lang.String endpoint)
Searches through all known regions to find one with any service at the specified endpoint. If no region is found with a service at that endpoint, an exception is thrown.

Parameters:
endpoint - The endpoint for any service residing in the desired region.
Returns:
The region containing any service running at the specified endpoint, otherwise an exception is thrown if no region is found with a service at the specified endpoint.
Throws:
java.net.MalformedURLException - If the given URL is malformed, or if the one of the service URLs on record is malformed.

init

public static void init()
Fetches the most recent version of the regions file from the remote source and caches it to the workspace metadata directory, then initializes the static list of regions with it.



Copyright © 2010 Amazon Web Services, Inc. All Rights Reserved.