GET /api/v1/dns/zone — получить список DNS-зон

Возвращает список DNS-зон, доступных в домене или лесу Active Directory.

Запрос

# Все зоны из всех партиций
curl -k --negotiate -u : \
  "https://<server>:<port>/api/v1/dns/zone"

# Только из стандартной партиции
curl -k --negotiate -u : \
  "https://<server>:<port>/api/v1/dns/zone?partition=domain"

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

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

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

partition

string

–

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

partitionName

string

–

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

scope

string

–

Тип зоны: primary, secondary, stub, forward. По умолчанию ищется по всем

Ответ "200 OK"

{
  "zones": [
    { "name": "example.com", "partition": "domain", "type": "ds-primary", ... },
    { "name": "apps.example.com", "partition": "custom", "type": "ds-primary", ... }
  ],
  "page": 1,
  "limit": 2,
  "total": 2,
  "totalPages": 1
}

Ошибки

Код Причина

400

Некорректное значение параметра: partition не из допустимого списка, scope неизвестен или partitionName указан при неверном partition

401

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

500

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

Обновлено: