This API method deletes an existing zone. Deleting a zone completely wipes all records, geohosts, targets and configurations. There is currently no “undo” so this method must be used with care.
Request
DELETE /zone/zone_name HTTP/1.0 Host: api.gslb.me Accept: encoding_type Authorization: Basic base64_credentials
Where:
- zone_name is the name of the zone you want to delete
- base64_credentials is username:password in base64-encoded format (HTTP Basic Authentication)
- encoding_type is either application/xml or application/json (if the “Accept” header is omitted, response will be JSON-encoded)
Sample requests:
- Raw request:
DELETE /zone/mydomain.com HTTP/1.0 Host: api.gslb.me Accept: application/json Content-Length: 0 Authorization: Basic dGVzdHVzZXJAZ3NsYi5tZTp0ZXN0cGFzc3dvcmQK
- Using curl:
curl -u testuser@gslb.me:testpassword -X DELETE -H "Accept: application/json" -k https://api.gslb.me/zone/mydomain.com
Response
- In case of success:
HTTP/1.1 200 OK Content-Type: application/json {"message":"Done","returncode":"0"}
- If the zone does not exist
HTTP/1.1 404 Not Found Content-Type: application/json {"message":"Zone not found","returncode":"2"}
- In case of internal error:
HTTP/1.1 500 Server Error Content-Type: application/json {"message":"Internal error, please contact support@gslb.me","returncode":"4"}