Управление DNS-узлами

DNS-узел — это имя хоста (FQDN), связанное с одной или несколькими DNS-записями (A, AAAA, CNAME и т. д.). Удаление узла удаляет все его записи за один запрос. Клиент elles-dns-cli предоставляет команду NodeDelete для безопасного и атомарного удаления узлов.

NodeDelete — удалить DNS-узел

Удаляет указанный DNS-узел и все его записи. По умолчанию команда не позволяет удалить узел, если в нем есть записи. В этом случае необходимо явно указать --force.

Параметры:

Параметр Описание

--name

FQDN узла (обязательно). Например: www.example.com

--force

Принудительное удаление даже при наличии записей (обязательно для успешного выполнения)

--tree

Удалить рекурсивно все дочерние узлы (например, sub.www.example.com, test.sub.www.example.com)

--zonename

Имя зоны (опционально; извлекается из --name автоматически)

--partition

Партиция: domain, forest, legacy, custom (по умолчанию: автоопределение)

--partitionname

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

Особенности использования:

  • без флага --force команда завершится ошибкой, даже если узел содержит только одну запись;

  • автоматическое определение зоны работает так же, как и в других командах: www.example.com → зона example.com;

  • если зона найдена в нескольких партициях и значение --partition не указано явно, удаление отклоняется.

Примеры использования

Удалить узел с принудительным удалением всех записей:

dnscli NodeDelete --name www.example.com --force

Удалить узел и все его подузлы (рекурсивно):

dnscli NodeDelete --name sub.example.com --tree --force

Удалить узел в пользовательской партиции:

dnscli NodeDelete --name apps.example.com --force --partition custom --partitionname MyAppPartition.EXAMPLE.COM

Удалить узел с явным указанием зоны (если автоопределение не работает):

dnscli NodeDelete --name _ldap._tcp.example.com --zonename example.com --force --partition domain

Всегда используйте --dry-run перед удалением, чтобы увидеть, какие записи будут удалены:

dnscli NodeDelete --name www.example.com --dry-run --force

Особенности и ограничения

При использовании команды учитывайте:

  • удаление узла — атомарная операция: либо все записи удаляются, либо ничего;

  • не удаляются делегирования (NS-записи в родительской зоне); они управляются отдельно через DelegationDelete;

  • флаг --tree удаляет только узлы, являющиеся DNS-потомками (например, a.b.example.com — потомок b.example.com, но x.example.com — нет);

  • для узлов с подчеркиваниями (_sip._tcp.example.com) всегда используйте --zonename;

  • команда не поддерживает массовое удаление нескольких узлов; каждая операция работает с одним узлом.

Обновлено: