POST /api/v1/dns/zone/{zoneName}/node — создать пустой DNS-узел

Создает пустой узел (owner node) в указанной DNS-зоне.

Узел не содержит записей, но может быть использован как контейнер для будущих RDATA-записей (A, CNAME, MX и др.).

Запрос

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

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

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

zoneName

string

✅

Имя зоны (FQDN)

partition

string

–

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

partitionName

string

–

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

name

string

✅

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

Ответ

При успешном создании возвращается статус 201 Created.

Ошибки

Код Причина

400

Отсутствует параметр name или его значение пусто; или partition=custom без partitionName

401

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

404

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

409

Узел уже существует в целевой зоне

500

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

Обновлено: