DELETEHOSTEDZONE()`¶

About DeleteHostedZone¶

Deletes a hosted zone.

If the hosted zone was created by another service, such as Cloud Map, see Deleting Public Hosted Zones That Were Created by Another Service in the Amazon Route 53 Developer Guide for information about how to delete it. (The process is the same for public and private hosted zones that were created by another service.)

If you want to keep your domain registration but you want to stop routing internet traffic to your website or web application, we recommend that you delete resource record sets in the hosted zone instead of deleting the hosted zone.

If you delete a hosted zone, you can't undelete it. You must create a new hosted zone and update the name servers for your domain registration, which can require up to 48 hours to take effect. (If you delegated responsibility for a subdomain to a hosted zone and you delete the child hosted zone, you must update the name servers in the parent hosted zone.) In addition, if you delete a hosted zone, someone could hijack the domain and route traffic to their own resources using your domain name.

If you want to avoid the monthly charge for the hosted zone, you can transfer DNS service for the domain to a free DNS service. When you transfer DNS service, you have to update the name servers for the domain registration. If the domain is registered with Route 53, see UpdateDomainNameservers for information about how to replace Route 53 name servers with name servers for the new DNS service. If the domain is registered with another registrar, use the method provided by the registrar to update name servers for the domain registration. For more information, perform an internet search on "free DNS service."

You can delete a hosted zone only if it contains only the default SOA and NS records and has DNSSEC signing disabled. If the hosted zone contains other records or has DNSSEC enabled, you must delete the records and disable DNSSEC before deletion. Attempting to delete a hosted zone with additional records or DNSSEC enabled returns a HostedZoneNotEmpty error. For information about deleting records, see ChangeResourceRecordSets.

To verify that the hosted zone has been deleted, do one of the following:

Use the GetHostedZone action to request information about the hosted zone.
Use the ListHostedZones action to get a list of the hosted zones associated with the current Amazon Web Services account.

Method Signature¶

METHODS /AWS1/IF_R53~DELETEHOSTEDZONE
  IMPORTING
    !IV_ID TYPE /AWS1/R53RESOURCEID OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_r53delhostedzonersp
  RAISING
    /AWS1/CX_R53HOSTEDZONENOTEMPTY
    /AWS1/CX_R53INVALIDDOMAINNAME
    /AWS1/CX_R53INVALIDINPUT
    /AWS1/CX_R53NOSUCHHOSTEDZONE
    /AWS1/CX_R53PRIORREQNOTCOMPL
    /AWS1/CX_R53CLIENTEXC
    /AWS1/CX_R53SERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_id` `TYPE /AWS1/R53RESOURCEID` `/AWS1/R53RESOURCEID`¶

The ID of the hosted zone you want to delete.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_r53delhostedzonersp` `/AWS1/CL_R53DELHOSTEDZONERSP`¶

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->deletehostedzone( |string| ).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lo_changeinfo = lo_result->get_changeinfo( ).
  IF lo_changeinfo IS NOT INITIAL.
    lv_resourceid = lo_changeinfo->get_id( ).
    lv_changestatus = lo_changeinfo->get_status( ).
    lv_timestamp = lo_changeinfo->get_submittedat( ).
    lv_resourcedescription = lo_changeinfo->get_comment( ).
  ENDIF.
ENDIF.

/AWS1/IF_R53=>DELETEHOSTEDZONE()¶