LISTHOSTEDZONESBYNAME()`¶

About ListHostedZonesByName¶

Retrieves a list of your hosted zones in lexicographic order. The response includes a HostedZones child element for each hosted zone created by the current Amazon Web Services account.

ListHostedZonesByName sorts hosted zones by name with the labels reversed. For example:

com.example.www.

Note the trailing dot, which can change the sort order in some circumstances.

If the domain name includes escape characters or Punycode, ListHostedZonesByName alphabetizes the domain name using the escaped or Punycoded value, which is the format that Amazon Route 53 saves in its database. For example, to create a hosted zone for exämple.com, you specify ex\344mple.com for the domain name. ListHostedZonesByName alphabetizes it as:

com.ex\344mple.

The labels are reversed and alphabetized using the escaped value. For more information about valid domain name formats, including internationalized domain names, see DNS Domain Name Format in the Amazon Route 53 Developer Guide.

Route 53 returns up to 100 items in each response. If you have a lot of hosted zones, use the MaxItems parameter to list them in groups of up to 100. The response includes values that help navigate from one group of MaxItems hosted zones to the next:

The DNSName and HostedZoneId elements in the response contain the values, if any, specified for the dnsname and hostedzoneid parameters in the request that produced the current response.
The MaxItems element in the response contains the value, if any, that you specified for the maxitems parameter in the request that produced the current response.
If the value of IsTruncated in the response is true, there are more hosted zones associated with the current Amazon Web Services account.

If IsTruncated is false, this response includes the last hosted zone that is associated with the current account. The NextDNSName element and NextHostedZoneId elements are omitted from the response.
The NextDNSName and NextHostedZoneId elements in the response contain the domain name and the hosted zone ID of the next hosted zone that is associated with the current Amazon Web Services account. If you want to list more hosted zones, make another call to ListHostedZonesByName, and specify the value of NextDNSName and NextHostedZoneId in the dnsname and hostedzoneid parameters, respectively.

Method Signature¶

METHODS /AWS1/IF_R53~LISTHOSTEDZONESBYNAME
  IMPORTING
    !IV_DNSNAME TYPE /AWS1/R53DNSNAME OPTIONAL
    !IV_HOSTEDZONEID TYPE /AWS1/R53RESOURCEID OPTIONAL
    !IV_MAXITEMS TYPE /AWS1/R53INTEGER OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_r53lsthostedzonesby01
  RAISING
    /AWS1/CX_R53INVALIDDOMAINNAME
    /AWS1/CX_R53INVALIDINPUT
    /AWS1/CX_R53CLIENTEXC
    /AWS1/CX_R53SERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Optional arguments:¶

`iv_dnsname` `TYPE /AWS1/R53DNSNAME` `/AWS1/R53DNSNAME`¶

(Optional) For your first request to ListHostedZonesByName, include the dnsname parameter only if you want to specify the name of the first hosted zone in the response. If you don't include the dnsname parameter, Amazon Route 53 returns all of the hosted zones that were created by the current Amazon Web Services account, in ASCII order. For subsequent requests, include both dnsname and hostedzoneid parameters. For dnsname, specify the value of NextDNSName from the previous response.

`iv_hostedzoneid` `TYPE /AWS1/R53RESOURCEID` `/AWS1/R53RESOURCEID`¶

(Optional) For your first request to ListHostedZonesByName, do not include the hostedzoneid parameter.

If you have more hosted zones than the value of maxitems, ListHostedZonesByName returns only the first maxitems hosted zones. To get the next group of maxitems hosted zones, submit another request to ListHostedZonesByName and include both dnsname and hostedzoneid parameters. For the value of hostedzoneid, specify the value of the NextHostedZoneId element from the previous response.

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

The maximum number of hosted zones to be included in the response body for this request. If you have more than maxitems hosted zones, then the value of the IsTruncated element in the response is true, and the values of NextDNSName and NextHostedZoneId specify the first hosted zone in the next group of maxitems hosted zones.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_r53lsthostedzonesby01` `/AWS1/CL_R53LSTHOSTEDZONESBY01`¶

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->listhostedzonesbyname(
  iv_dnsname = |string|
  iv_hostedzoneid = |string|
  iv_maxitems = 123
).

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_hostedzones( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_resourceid = lo_row_1->get_id( ).
      lv_dnsname = lo_row_1->get_name( ).
      lv_nonce = lo_row_1->get_callerreference( ).
      lo_hostedzoneconfig = lo_row_1->get_config( ).
      IF lo_hostedzoneconfig IS NOT INITIAL.
        lv_resourcedescription = lo_hostedzoneconfig->get_comment( ).
        lv_isprivatezone = lo_hostedzoneconfig->get_privatezone( ).
      ENDIF.
      lv_hostedzonerrsetcount = lo_row_1->get_resourcerecordsetcount( ).
      lo_linkedservice = lo_row_1->get_linkedservice( ).
      IF lo_linkedservice IS NOT INITIAL.
        lv_serviceprincipal = lo_linkedservice->get_serviceprincipal( ).
        lv_resourcedescription = lo_linkedservice->get_description( ).
      ENDIF.
      lo_hostedzonefeatures = lo_row_1->get_features( ).
      IF lo_hostedzonefeatures IS NOT INITIAL.
        lv_acceleratedrecoverystat = lo_hostedzonefeatures->get_accdrecoverystatus( ).
        lo_hostedzonefailurereason = lo_hostedzonefeatures->get_failurereasons( ).
        IF lo_hostedzonefailurereason IS NOT INITIAL.
          lv_failurereason = lo_hostedzonefailurereason->get_acceleratedrecovery( ).
        ENDIF.
      ENDIF.
    ENDIF.
  ENDLOOP.
  lv_dnsname = lo_result->get_dnsname( ).
  lv_resourceid = lo_result->get_hostedzoneid( ).
  lv_pagetruncated = lo_result->get_istruncated( ).
  lv_dnsname = lo_result->get_nextdnsname( ).
  lv_resourceid = lo_result->get_nexthostedzoneid( ).
  lv_integer = lo_result->get_maxitems( ).
ENDIF.

/AWS1/IF_R53=>LISTHOSTEDZONESBYNAME()¶