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

Удаляет DNS-узел (owner node) и все записи в нем.

По умолчанию запрещает удаление непустых узлов.

Для удаления узлов с записями используйте force=true. Для удаления всей ветви дочерних узлов — tree=true.

Запрос

curl -k --negotiate -u : -X DELETE \
  "https://<server>:<port>/api/v1/dns/zone/example.com/node?partition=domain&name=empty&tree=true&force=true"

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

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

zoneName

string

✅

Имя зоны (FQDN)

partition

string

–

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

partitionName

string

–

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

name

string

✅

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

tree

bool

–

true — рекурсивно удалить все дочерние узлы и их записи

force

bool

–

true — удалить узел, даже если он содержит записи

Ответ

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

Ошибки

Код Причина

400

Отсутствует обязательный параметр name; или partition=custom без partitionName

401

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

404

Зона не найдена в указанной партиции; или узел не существует

409

Узел содержит записи и force=false

422

Попытка удалить корневой узел зоны (@)

500

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

Обновлено: