LISTGEOLOCATIONS()`¶

About ListGeoLocations¶

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.

Method Signature¶

METHODS /AWS1/IF_R53~LISTGEOLOCATIONS
  IMPORTING
    !IV_STARTCONTINENTCODE TYPE /AWS1/R53GEOLOCCONTINENTCODE OPTIONAL
    !IV_STARTCOUNTRYCODE TYPE /AWS1/R53GEOLOCCOUNTRYCODE OPTIONAL
    !IV_STARTSUBDIVISIONCODE TYPE /AWS1/R53GEOLOCSUBDIVISIONCODE OPTIONAL
    !IV_MAXITEMS TYPE /AWS1/R53INTEGER OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_r53listgeolocsrsp
  RAISING
    /AWS1/CX_R53INVALIDINPUT
    /AWS1/CX_R53CLIENTEXC
    /AWS1/CX_R53SERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Optional arguments:¶

`iv_startcontinentcode` `TYPE /AWS1/R53GEOLOCCONTINENTCODE` `/AWS1/R53GEOLOCCONTINENTCODE`¶

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.

`iv_startcountrycode` `TYPE /AWS1/R53GEOLOCCOUNTRYCODE` `/AWS1/R53GEOLOCCOUNTRYCODE`¶

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.

`iv_startsubdivisioncode` `TYPE /AWS1/R53GEOLOCSUBDIVISIONCODE` `/AWS1/R53GEOLOCSUBDIVISIONCODE`¶

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.

`iv_maxitems` `TYPE /AWS1/R53INTEGER` `/AWS1/R53INTEGER`¶

(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.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_r53listgeolocsrsp` `/AWS1/CL_R53LISTGEOLOCSRSP`¶

Domain /AWS1/RT_ACCOUNT_ID

Primitive Type NUMC

Examples¶

Syntax Example¶

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->listgeolocations(
  iv_maxitems = 123
  iv_startcontinentcode = |string|
  iv_startcountrycode = |string|
  iv_startsubdivisioncode = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  LOOP AT lo_result->get_geolocationdetailslist( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_geolocationcontinentcod = lo_row_1->get_continentcode( ).
      lv_geolocationcontinentnam = lo_row_1->get_continentname( ).
      lv_geolocationcountrycode = lo_row_1->get_countrycode( ).
      lv_geolocationcountryname = lo_row_1->get_countryname( ).
      lv_geolocationsubdivisionc = lo_row_1->get_subdivisioncode( ).
      lv_geolocationsubdivisionn = lo_row_1->get_subdivisionname( ).
    ENDIF.
  ENDLOOP.
  lv_pagetruncated = lo_result->get_istruncated( ).
  lv_geolocationcontinentcod = lo_result->get_nextcontinentcode( ).
  lv_geolocationcountrycode = lo_result->get_nextcountrycode( ).
  lv_geolocationsubdivisionc = lo_result->get_nextsubdivisioncode( ).
  lv_integer = lo_result->get_maxitems( ).
ENDIF.

/AWS1/IF_R53=>LISTGEOLOCATIONS()¶