libZSservicesZSamazonka-route53ZSamazonka-route53
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.Route53.DeleteHostedZone

Description

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 record and NS resource record sets. If the hosted zone contains other resource record sets, you must delete them before you can delete the hosted zone. If you try to delete a hosted zone that contains other resource record sets, the request fails, and Route 53 returns a HostedZoneNotEmpty error. For information about deleting records from your hosted zone, 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.
Synopsis

Creating a Request

data DeleteHostedZone Source #

A request to delete a hosted zone.

See: newDeleteHostedZone smart constructor.

Constructors

DeleteHostedZone' 

Fields

  • id :: ResourceId

    The ID of the hosted zone you want to delete.

Instances

Instances details
Eq DeleteHostedZone Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

Read DeleteHostedZone Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

Show DeleteHostedZone Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

Generic DeleteHostedZone Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

Associated Types

type Rep DeleteHostedZone :: Type -> Type #

NFData DeleteHostedZone Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

Methods

rnf :: DeleteHostedZone -> () #

Hashable DeleteHostedZone Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

AWSRequest DeleteHostedZone Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

Associated Types

type AWSResponse DeleteHostedZone #

ToHeaders DeleteHostedZone Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

ToPath DeleteHostedZone Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

ToQuery DeleteHostedZone Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

type Rep DeleteHostedZone Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

type Rep DeleteHostedZone = D1 ('MetaData "DeleteHostedZone" "Amazonka.Route53.DeleteHostedZone" "libZSservicesZSamazonka-route53ZSamazonka-route53" 'False) (C1 ('MetaCons "DeleteHostedZone'" 'PrefixI 'True) (S1 ('MetaSel ('Just "id") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 ResourceId)))
type AWSResponse DeleteHostedZone Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

newDeleteHostedZone Source #

Create a value of DeleteHostedZone with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:id:DeleteHostedZone', deleteHostedZone_id - The ID of the hosted zone you want to delete.

Request Lenses

deleteHostedZone_id :: Lens' DeleteHostedZone ResourceId Source #

The ID of the hosted zone you want to delete.

Destructuring the Response

data DeleteHostedZoneResponse Source #

A complex type that contains the response to a DeleteHostedZone request.

See: newDeleteHostedZoneResponse smart constructor.

Constructors

DeleteHostedZoneResponse' 

Fields

  • httpStatus :: Int

    The response's http status code.

  • changeInfo :: ChangeInfo

    A complex type that contains the ID, the status, and the date and time of a request to delete a hosted zone.

Instances

Instances details
Eq DeleteHostedZoneResponse Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

Read DeleteHostedZoneResponse Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

Show DeleteHostedZoneResponse Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

Generic DeleteHostedZoneResponse Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

Associated Types

type Rep DeleteHostedZoneResponse :: Type -> Type #

NFData DeleteHostedZoneResponse Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

type Rep DeleteHostedZoneResponse Source # 
Instance details

Defined in Amazonka.Route53.DeleteHostedZone

type Rep DeleteHostedZoneResponse = D1 ('MetaData "DeleteHostedZoneResponse" "Amazonka.Route53.DeleteHostedZone" "libZSservicesZSamazonka-route53ZSamazonka-route53" 'False) (C1 ('MetaCons "DeleteHostedZoneResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int) :*: S1 ('MetaSel ('Just "changeInfo") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 ChangeInfo)))

newDeleteHostedZoneResponse Source #

Create a value of DeleteHostedZoneResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:httpStatus:DeleteHostedZoneResponse', deleteHostedZoneResponse_httpStatus - The response's http status code.

$sel:changeInfo:DeleteHostedZoneResponse', deleteHostedZoneResponse_changeInfo - A complex type that contains the ID, the status, and the date and time of a request to delete a hosted zone.

Response Lenses

deleteHostedZoneResponse_changeInfo :: Lens' DeleteHostedZoneResponse ChangeInfo Source #

A complex type that contains the ID, the status, and the date and time of a request to delete a hosted zone.