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

Удаляет DNS-зону и все ее записи.

По умолчанию запрещает удаление непустых зон. Для принудительного удаления используйте параметр force=true.

Запрос

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

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

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

zoneName

string

✅

Имя зоны (FQDN)

partition

string

–

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

partitionName

string

–

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

force

bool

–

true — удалить рекурсивно, включая все записи; false (по умолчанию) — удалить только пустую зону

Ответ "204 No Content"

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

Ошибки

Код Причина

400

Некорректный параметр partition (не из списка domain, forest, legacy, custom) или отсутствует partitionName при partition=custom

401

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

404

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

409

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

422

Зона непустая и force=false

500

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

Обновлено: