Deleting a Record Set

Function

This API is used to delete a record set. To delete a record set with intelligent resolution configured, you need to use the API in the multi-line record set management.

Calling Method

For details, see Calling APIs.

URI

DELETE /v2/zones/{zone_id}/recordsets/{recordset_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
zone_id	Yes	String	ID of the zone to which the record set belongs
recordset_id	Yes	String	Record set ID

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. It can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token.

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
id	String	Record set ID
name	String	Record set name
description	String	Record set description
zone_id	String	Zone ID of the record set
zone_name	String	Zone name of the record set
type	String	Record set type
ttl	Integer	Record set caching duration (in seconds) on a local DNS server. The longer the duration is, the slower the update takes effect.
records	Array of strings	Record set value
create_at	String	Time when the record set was created
update_at	String	Time when the record set was updated
status	String	Resource status
default	Boolean	Whether the record set is generated by the system. A system-generated record set cannot be deleted.
project_id	String	Project ID of the record set
links	pageLink object	Link of the current resource or other related resources. When a response is broken into pages, a next link is provided to retrieve all results.

**Table 4** pageLink
Parameter	Type	Description
self	String	Link to the current resource
next	String	Link to the next page

Example Requests

None

Example Responses

Status code: 200

Response to the request for deleting a record set

{
  "id" : "2c9eb155587228570158722b6ac30007",
  "name" : "www.example.com.",
  "description" : "This is an example record set.",
  "type" : "A",
  "ttl" : 300,
  "status" : "PENDING_DELETE",
  "links" : {
    "self" : "https://Endpoint/v2/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30007"
  },
  "zone_id" : "2c9eb155587194ec01587224c9f90149",
  "zone_name" : "example.com.",
  "create_at" : "2016-11-17T12:03:17.827",
  "update_at" : "2016-11-17T12:56:03.827",
  "default" : false,
  "project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c"
}