DELETE /api/v1/dns/zone/{zoneName}/record — удалить DNS-запись

Удаляет конкретную DNS-запись из зоны по совокупности параметров: имя узла, тип записи и текущее значение.

Запрос

curl -k --negotiate -u : -X DELETE \
  "https://<server>:<port>/api/v1/dns/zone/example.com/record?partition=domain&name=www&type=A&rdata=192.168.1.10"

Параметры запроса

Параметр Тип Обязательный Описание

zoneName

string

✅

Имя зоны (FQDN)

partition

string

–

Партиция, в которой находится зона: domain, forest, legacy, custom

partitionName

string

–

Имя пользовательской партиции (обязательно при partition=custom)

name

string

✅

Имя узла (без домена). Например: www, @ (для корня), mail

type

string

✅

Тип записи: A, AAAA, CNAME, MX, NS, PTR, SRV, TXT

rdata

string

✅

Значение записи в формате, соответствующем типу. Для CNAME, MX, NS, PTR, SRV обязательно оканчивается на точку

Ответ

При успешном удалении возвращается статус 204 No Content.

Ошибки

Код Причина

400

Удаление SOA-записи на вершине зоны запрещено; отсутствует один из обязательных параметров (name, type, rdata)

401

Отсутствует или невалиден билет Kerberos (SPNEGO)

404

Зона или запись не найдена

409

Зона существует в нескольких партициях — требуется явное указание partition (ответ содержит availablePartitions)

500

Внутренняя ошибка сервера при удалении записи

Обновлено: