Delete zone (DELETE /v1.0/hostedzone/{zoneId})

  • Deletes a zone.
  • Specify the zone to be deleted by using the zone ID in the request.
  • When a zone is deleted, all records that have been set for that zone are also deleted.
  • Even if a zone is deleted, the domain will not be discontinued.
  • If a delete zone API is executed concurrently with operation of the record update API in the same zone, a 500 Internal Error will occur, so retry the operation.
  • If there is a PTR record in a zone, a 409 Conflict will occur. Delete any existing PTR records before performing deletion.

*The zone ID is the same value as the zone name.

Request headers

n/a

Request parameters

n/a

Request elements

n/a

HTTP status

Status

The following error codes can be returned for the request.

One of the following values will be returned:
200:
Normal completion
400:
Invalid input parameter
404:
A zone with the specified ID does not exist
409:
There is a PTR record in the zone
Data type Cardinality
Int 1..1

Response elements (normal completion)

DeleteHostedZoneResponse

Envelope of the response.

Data type Cardinality Parent element Child element
- 1..1 None ChangeInfo

ChangeInfo

Envelope of the update request information.

Data type Cardinality Parent element Child element
- 1..1 ListHostedZonesResponse Id

Status

SubmittedAt

Id

Update request ID.

Data type Cardinality Parent element Child element
xsd:string 1..1 ChangeInfo None

Status

Update status.

PENDING or INSYNC.

Data type Cardinality Parent element Child element
xsd:string 1..1 ChangeInfo None

SubmittedAt

Datetime of update request. Format: YYYY-MM-DDThh:mm:ss.SSSZ

Data type Cardinality Parent element Child element
xsd:string 1..1 ChangeInfo None

Example of request


DELETE /hostedzone/example.com HTTP/1.1
Date: Fri, 06 Jun 2014 11:00:37 GMT
Content-Length: . . .
Host: dns.gls.cloud.global.fujitsu.com
Accept: application/xml
X-Auth-Token: MIIFvgY. . .
     

Example of response


HTTP/1.1 200 OK
Date: Fri, 06 Jun 2014 11:00:38 GMT
Content-Length: . . .
Content-Type: application/xml
x-fj-request-id: d96bd874-9bf2-11e1-8ee7-c98a0037a2b6
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
< DeleteHostedZoneResponse xmlns="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/">
  <ChangeInfo>
    <Id>d36956475553d655cf70a293adeb155c</Id>
    <Status>INSYNC</Status>
    <SubmittedAt>2014-06-06T11:00:38.178Z</SubmittedAt>
  </ChangeInfo>
</DeleteHostedZoneResponse>