com.amazonaws.regions

Class RegionUtils

java.lang.Object

com.amazonaws.regions.RegionUtils

public class RegionUtils
extends Object

Utilities for working with regions.

Constructor Summary

Constructors

Constructor and Description
RegionUtils()

Method Summary

Modifier and Type	Method and Description
static Region	getRegion(String regionName)
static Region	getRegionByEndpoint(String endpoint) Searches through all known regions to find one with any service at the specified endpoint.
static List<Region>	getRegions()
static List<Region>	getRegionsForService(String serviceAbbreviation)
static void	init() There is no need to call this method, it is public only for Compatibility.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RegionUtils

public RegionUtils()

Method Detail

getRegions

public static List<Region> getRegions()

Returns:

a list of the available AWS regions.

getRegionsForService

public static List<Region> getRegionsForService(String serviceAbbreviation)

Parameters:

serviceAbbreviation - the service abbreviation.

Returns:

a list of the regions that support the service given.

See Also:

ServiceAbbreviations

getRegion

public static Region getRegion(String regionName)

Parameters:

regionName - the region name.

Returns:

the region with the id given, if it exists. Otherwise, returns null.

getRegionByEndpoint

public static Region getRegionByEndpoint(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:

MalformedURLException - If the given URL is malformed, or if the one of the service URLs on record is malformed.

init

public static void init()

There is no need to call this method, it is public only for Compatibility. Every regions method makes sure this method has already been called. This method will load the regions (specified by the developer if the system property SDKGlobalConfiguraiton.REGIONS_FILE_OVERRIDE_SYSTEM_PROPERTY is set, or the defaults shipped with the SDK) into memory.