Delete a Recordset¶
Overview¶
- Delete a recordset
Classification¶
- Delete
API Operation Object¶
- Recordset
Synchronous / Asynchronous¶
- Synchronous
Request¶
HTTP Request Method¶
- DELETE
HTTP Request Path¶
{api_endpoint}/v2/zones/{zone_id}/recordsets/{recordset_id}
HTTP Request Header¶
Format¶
Content-Type: application/json
Accept: application/json
X-Auth-Token: <token_id>
HTTP Request Body¶
- none
Request Parameter¶
| name | style | format | description | required/optional | default value | action for invalid parameter | response code for invalid parameter |
|---|---|---|---|---|---|---|---|
| token_id | header | authentication token string | authentication token | required | - | Terminate | 401 |
| zone_id | path | uuid | ID for the zone | required | - | Terminate | 400,404 |
| recordset_id | path | uuid | ID for the recordset | required | - | Terminate | 400,403,404 |
Response¶
HTTP Response Header¶
Response Code¶
| response code | status | condition | message |
|---|---|---|---|
| 204 | No Content | normal end | |
| 400 | Bad Request | invalid value | E2042 Zone id is required. |
| 403 | Forbidden | forbidden | E2062 Default NS recordset can't delete. |
| Forbidden | forbidden | E2063 Default SOA recordset can't modify. | |
| 404 | Not Found | not exists | E2007 Specified zone is not found. |
| Not Found | not exists | E2008 Specified recordset is not found. | |
| 401 | Unauthorized | authentication failure | E2001 Invalid token. |
| 500 | Internal Server Error | internal server error | E9001 Internal Server Error. Request failed. |
Sample Request and Response¶
Sample API Request¶
Request URL¶
DELETE /v2/zones/fbe8562b-66a5-4071-b4c2-250487d15a81/recordsets/2514d0c1-d41e-4fd0-b736-acf3fbd1e03a
Request Header¶
Content-Type: application/json
Accept: application/json
X-Auth-Token: e8c788fbaeb14964ae19759eb1df4ff1
Request Body¶
- none
Sample API Response¶
Response Header¶
HTTP/1.1 204
Date: Mon, 24 Oct 2016 06:32:17 GMT
Connection: keep-alive
Set-Cookie: TS0183560f=01cce65ce1a9b4bad9a75c63c2ba25247b78708a009952cb20bc4248f5da08399d51c5528f; Path=/
Response Body¶
- none
Sample Error Response¶
Response¶
HTTP/1.1 404
Date: Mon, 24 Oct 2016 06:32:30 GMT
Content-Type: application/json
Content-Length: 94
Connection: keep-alive
Set-Cookie: TS0183560f=01cce65ce18b6ed4db4bb2cc92d7bdcf47206c5fd2454b51e86f27c10dd11b0aee5500e33c; Path=/
{"error":{"code":404,"title":"Not Found","message":"E2008 Specified recordset is not found."}}