GET /api/v1/dns/zone/{zoneName} — получить DNS-зону

Возвращает информацию о DNS-зоне по ее имени.

Запрос

# С указанием партиции
curl -k --negotiate -u : \
  "https://<server>:<port>/api/v1/dns/zone/example.com?partition=domain"

# Без указания партиции (disambiguation)
curl -k --negotiate -u : \
  "https://<server>:<port>/api/v1/dns/zone/example.com"

# В пользовательской партиции
curl -k --negotiate -u : \
  "https://<server>:<port>/api/v1/dns/zone/apps.example.com?partition=custom&partitionName=MyApp"

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

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

zoneName

string

✅

Имя зоны (FQDN)

partition

string

–

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

partitionName

string

–

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

Ответ "200 OK"

{
  "name": "example.com",
  "nameUnicode": "example.com",
  "partition": "domain",
  "type": "ds-primary",
  "zoneType": 1,
  "defaultTtl": 3600,
  "allowUpdate": 2,
  "noRefreshInterval": 168,
  "refreshInterval": 168,
  "agingEnabled": false,
  "masterIP": []
}

Ошибки

Код Причина

400

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

401

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

404

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

409

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

422

Пользовательская партиция partitionName не найдена или недоступна (например, INSUFFICIENT_ACCESS, NO_SUCH_OBJECT)

500

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

Обновлено: