Updated on 2024-03-25 GMT+08:00

Batch Deleting Record Sets in a Zone

Function

This API is used to batch delete record sets in a zone. If the record sets to be deleted do not exist, the record sets are considered deleted by default. The response contains only record sets that are actually deleted.

Calling Method

For details, see Calling APIs.

URI

DELETE /v2.1/zones/{zone_id}/recordsets

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

zone_id

Yes

String

Zone 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.

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

recordset_ids

Yes

Array of strings

List of record set IDs You can specify a maximum of 100 IDs.

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

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.

recordsets

Array of QueryRecordSetWithLineResp objects

Record set list

metadata

metadata object

Number of resources that meet the query condition

Table 5 QueryRecordSetWithLineResp

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

created_at

String

Time when the record set was created

updated_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.

line

String

Resolution line ID

weight

Integer

Weight of the record set

health_check_id

String

Health check ID

alias_target

alias_target object

Domain name alias

bundle

String

Specification, which is the default specification. This field is reserved.

Table 7 alias_target

Parameter

Type

Description

resource_type

String

Service that supports domain name aliases.

Value options:

  • cloudsite: CloudSite

  • waf: Web Application Firewall

resource_domain_name

String

Domain name of the target service

Table 8 metadata

Parameter

Type

Description

total_count

Integer

Number of resources that meet the filter criteria. The number is irrelevant to limit or offset.

Example Requests

Deleting record sets added to a zone in batches

DELETE https://{endpoint}/v2.1/zones/{zone_id}/recordsets

{
  "recordset_ids" : [ "2c9eb155587194ec01587224c9f9014a", "2c9eb155587194ec01587224c9f9014c" ]
}

Example Responses

Status code: 200

Response to the request for batch deleting record sets in a zone

{
  "links" : {
    "self" : "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets"
  },
  "recordsets" : [ {
    "id" : "2c9eb155587194ec01587224c9f9014a",
    "name" : "example.com.",
    "type" : "A",
    "ttl" : 300,
    "records" : [ "1.1.1.1" ],
    "status" : "PENDING_DELETE",
    "links" : {
      "self" : "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587194ec01587224c9f9014a"
    },
    "zone_id" : "2c9eb155587194ec01587224c9f90149",
    "zone_name" : "example.com.",
    "created_at" : "2016-11-17T11:56:03.439",
    "updated_at" : "2016-11-17T11:56:06.439",
    "default" : false,
    "project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c",
    "line" : "default_view",
    "weight" : null,
    "set_id" : null
  }, {
    "id" : "2c9eb155587194ec01587224c9f9014c",
    "name" : "1.example.com.",
    "type" : "A",
    "ttl" : 172800,
    "records" : [ "2.2.2.2" ],
    "status" : "PENDING_DELETE",
    "links" : {
      "self" : "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587194ec01587224c9f9014c"
    },
    "zone_id" : "2c9eb155587194ec01587224c9f90149",
    "zone_name" : "example.com.",
    "created_at" : "2016-11-17T11:56:03.439",
    "updated_at" : "2016-11-17T11:56:06.439",
    "default" : false,
    "project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c",
    "line" : "default_view",
    "weight" : null,
    "set_id" : null
  } ],
  "metadata" : {
    "total_count" : 2
  }
}

Status Codes

Status Code

Description

200

Response to the request for batch deleting record sets in a zone

Error Codes

See Error Codes.