Delete multiple Recordsets¶

Overview¶

Delete multiple Recordsets

Classification¶

Delete

API Operation Object¶

Recordset

Synchronous / Asynchronous¶

Synchronous

Request¶

HTTP Request Method¶

DELETE

HTTP Request Path¶

{api_endpoint}/v2/zones/{zone_id}/recordsets

HTTP Request Header¶

Format¶

Content-Type: application/json
Accept: application/json
X-Auth-Token: <token_id>

HTTP Request Body¶

Format¶

{
  "id" : <recordset_ids>
}

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_ids	body	uuid list	A list of IDs for the recordsets.	required	-	Terminate	400,403,404

Response¶

HTTP Response Header¶

Format¶

HTTP/1.1 <response_code>       (ex. 200)

<response_code>: see "Response Code" section

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.

Response Body¶

none

Response Parameter¶

none

Sample Request and Response¶

Sample API Request¶

Request URL¶

DELETE /v2/zones/fbe8562b-66a5-4071-b4c2-250487d15a81/recordsets

Request Header¶

Content-Type: application/json
Accept: application/json
X-Auth-Token: e8c788fbaeb14964ae19759eb1df4ff1

Request Body¶

{
  "id" : ["2514d0c1-d41e-4fd0-b736-acf3fbd1e03a","0af8f6a2-e7c8-4243-a7f6-c505725973e4"]
}

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."}}

Delete a Recordset

Show a Recordset