Menu
Amazon Route 53
API Reference

DeleteHostedZone

Deletes a hosted zone.

Important

If the name servers for the hosted zone are associated with a domain and if you want to make the domain unavailable on the Internet, we recommend that you delete the name servers from the domain to prevent future DNS queries from possibly being misrouted. If the domain is registered with Amazon Route 53, see UpdateDomainNameservers. If the domain is registered with another registrar, use the method provided by the registrar to delete name servers for the domain.

Some domain registries don't allow you to remove all of the name servers for a domain. If the registry for your domain requires one or more name servers, we recommend that you delete the hosted zone only if you transfer DNS service to another service provider, and you replace the name servers for the domain with name servers from the new provider.

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 Amazon 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 AWS account.

Request Syntax

DELETE /2013-04-01/hostedzone/Id HTTP/1.1

URI Request Parameters

The request requires the following URI parameters.

Id

The ID of the hosted zone you want to delete.

Length Constraints: Maximum length of 32.

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 <?xml version="1.0" encoding="UTF-8"?> <DeleteHostedZoneResponse> <ChangeInfo> <Comment>string</Comment> <Id>string</Id> <Status>string</Status> <SubmittedAt>timestamp</SubmittedAt> </ChangeInfo> </DeleteHostedZoneResponse>

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in XML format by the service.

DeleteHostedZoneResponse

Root level tag for the DeleteHostedZoneResponse parameters.

Required: Yes

ChangeInfo

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

Type: ChangeInfo object

Errors

For information about the errors that are common to all actions, see Common Errors.

HostedZoneNotEmpty

The hosted zone contains resource records that are not SOA or NS records.

HTTP Status Code: 400

InvalidDomainName

The specified domain name is not valid.

HTTP Status Code: 400

InvalidInput

The input is not valid.

HTTP Status Code: 400

NoSuchHostedZone

No hosted zone exists with the ID that you specified.

HTTP Status Code: 404

PriorRequestNotComplete

If Amazon Route 53 can't process a request before the next request arrives, it will reject subsequent requests for the same hosted zone and return an HTTP 400 error (Bad request). If Amazon Route 53 returns this error repeatedly for the same request, we recommend that you wait, in intervals of increasing duration, before you try the request again.

HTTP Status Code: 400

Examples

Example Request

DELETE /2013-04-01/hostedzone/Z1PA6795UKMFR9

Example Response

HTTP/1.1 200 OK <?xml version="1.0" encoding="UTF-8"?> <DeleteHostedZoneResponse xmlns="https://route53.amazonaws.com/doc/2013-04-01/"> <ChangeInfo> <Id>/change/C1PA6795UKMFR9</Id> <Status>PENDING</Status> <SubmittedAt>2017-03-10T01:36:41.958Z</SubmittedAt> </ChangeInfo> </DeleteHostedZoneResponse>

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: