GET /api/v1/dns/zone/{zoneName}/delegation — получить список делегирований DNS-зоны

Возвращает все NS-записи, которые делегируют указанную дочернюю зону в родительской зоне.

Запрос

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

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

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

zoneName

string

✅

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

partition

string

–

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

partitionName

string

–

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

name

string

✅

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

Ответ "200 OK"

{
  "delegations": [
    {
      "name": "sub",
      "nameUnicode": "sub",
      "nsServer": "ns1.sub.example.com",
      "nsServerUnicode": "ns1.sub.example.com",
      "ttl": 7200
    },
    {
      "name": "sub",
      "nameUnicode": "sub",
      "nsServer": "ns2.sub.example.com",
      "nsServerUnicode": "ns2.sub.example.com",
      "ttl": 3600
    }
  ]
}

Ошибки

Код Причина

400

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

401

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

500

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

Обновлено: