DELETE /api/v1/dns/zone/{zoneName}/delegation — удалить делегирование DNS-зоны

Удаляет NS-запись по совокупности параметров: имя дочерней зоны и FQDN NS-сервера.

Запрос

curl -k --negotiate -u : -X DELETE \
  "https://<server>:<port>/api/v1/dns/zone/example.com/delegation?partition=domain&name=sub&nsServer=ns1.sub.example.com"

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

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

zoneName

string

✅

Имя родительской зоны (FQDN)

partition

string

–

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

partitionName

string

–

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

name

string

✅

Имя дочерней зоны (без родительского домена). Например: sub, apps. Не может быть пустым или содержать точки

nsServer

string

✅

FQDN NS-сервера, идентифицирующее удаляемую запись. Должно совпадать с текущим значением в делегировании

Ответ "204 No Content"

Успешное удаление возвращает пустой ответ с кодом 204.

Ошибки

Код Причина

400

Отсутствует обязательный параметр name или nsServer; значение name содержит точки или недопустимые символы

401

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

404

Родительская зона не найдена в указанной партиции; или NS-запись с указанным nsServer не существует

409

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

500

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

Обновлено: