Skip to content

List Geo Locations

route53_list_geo_locations R Documentation

Retrieves a list of supported geographic locations

Description

Retrieves a list of supported geographic locations.

Countries are listed first, and continents are listed last. If Amazon Route 53 supports subdivisions for a country (for example, states or provinces), the subdivisions for that country are listed in alphabetical order immediately after the corresponding country.

Route 53 does not perform authorization for this API because it retrieves information that is already available to the public.

For a list of supported geolocation codes, see the GeoLocation data type.

Usage

route53_list_geo_locations(StartContinentCode, StartCountryCode,
  StartSubdivisionCode, MaxItems)

Arguments

StartContinentCode

The code for the continent with which you want to start listing locations that Amazon Route 53 supports for geolocation. If Route 53 has already returned a page or more of results, if IsTruncated is true, and if NextContinentCode from the previous response has a value, enter that value in startcontinentcode to return the next page of results.

Include startcontinentcode only if you want to list continents. Don't include startcontinentcode when you're listing countries or countries with their subdivisions.

StartCountryCode

The code for the country with which you want to start listing locations that Amazon Route 53 supports for geolocation. If Route 53 has already returned a page or more of results, if IsTruncated is true, and if NextCountryCode from the previous response has a value, enter that value in startcountrycode to return the next page of results.

StartSubdivisionCode

The code for the state of the United States with which you want to start listing locations that Amazon Route 53 supports for geolocation. If Route 53 has already returned a page or more of results, if IsTruncated is true, and if NextSubdivisionCode from the previous response has a value, enter that value in startsubdivisioncode to return the next page of results.

To list subdivisions (U.S. states), you must include both startcountrycode and startsubdivisioncode.

MaxItems

(Optional) The maximum number of geolocations to be included in the response body for this request. If more than maxitems geolocations remain to be listed, then the value of the IsTruncated element in the response is true.

Value

A list with the following syntax:

list(
  GeoLocationDetailsList = list(
    list(
      ContinentCode = "string",
      ContinentName = "string",
      CountryCode = "string",
      CountryName = "string",
      SubdivisionCode = "string",
      SubdivisionName = "string"
    )
  ),
  IsTruncated = TRUE|FALSE,
  NextContinentCode = "string",
  NextCountryCode = "string",
  NextSubdivisionCode = "string",
  MaxItems = "string"
)

Request syntax

svc$list_geo_locations(
  StartContinentCode = "string",
  StartCountryCode = "string",
  StartSubdivisionCode = "string",
  MaxItems = "string"
)