PUT /api/v1/dns/zone/{zoneName}/delegation — изменить NS-сервер делегирования зоны DNS

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

Запрос

curl -k --negotiate -u : -X PUT \
  "https://<server>:<port>/api/v1/dns/zone/example.com/delegation?partition=domain" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "sub",
    "oldNsServer": "ns1.sub.example.com",
    "nsServer": "ns2.sub.example.com",
    "ttl": 3600
  }'

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

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

zoneName

string

✅

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

partition

string

–

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

partitionName

string

–

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

Поля тела запроса

Поле Тип Обязательное Описание и значения

name

string

✅

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

oldNsServer

string

✅

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

nsServer

string

✅

Новое FQDN авторитативного DNS-сервера для делегированной зоны. Должно быть разрешаемым в IP-адрес

ttl

uint32

–

Новое время жизни NS-записи. Значение 0 означает сохранение текущего TTL. Диапазон: 1–86400 секунд

Ответ "200 OK"

{
  "name": "sub",
  "nameUnicode": "sub",
  "nsServer": "ns2.sub.example.com",
  "nsServerUnicode": "ns2.sub.example.com",
  "ttl": 7200
}

Ошибки

Код Причина

400

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

401

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

404

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

409

Дочерняя зона существует, но в другой партиции; или новая NS-запись уже существует

500

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

Обновлено: