GET /api/v1/dns/partitions — получить список партиций

Возвращает список всех партиций, обнаруженных в Active Directory.

Запрос

curl -k --negotiate -u : \
  "https://<server>:<port>/api/v1/dns/partitions"

Ответ "200 OK"

{
  "partitions": [
    {
      "name": "DomainDnsZones",
      "dn": "DC=DomainDnsZones,DC=example,DC=com",
      "kind": "domain",
      "available": true
    },
    {
      "name": "ForestDnsZones",
      "dn": "DC=ForestDnsZones,DC=example,DC=com",
      "kind": "forest",
      "available": true
    },
    {
      "name": "System",
      "dn": "CN=System,DC=example,DC=com",
      "kind": "legacy",
      "available": true
    },
    {
      "name": "MyAppPartition",
      "dn": "DC=MyAppPartition,DC=example,DC=com",
      "kind": "custom",
      "available": true,
      "replica_dcs": ["CN=NTDS Settings,CN=WIN-DC1,..."]
    }
  ]
}

Поля объекта "Partition"

Поле Тип Описание

name

string

Человекочитаемое имя (из dnsRoot, не GUID)

dn

string

Полное DN-имя партиции

kind

string

domain / forest / legacy / custom

available

bool

Доступна ли партиция для операций

replica_dcs

array

Список контроллеров домена с репликой (из msDS-NCReplicaLocations)

unavailable_reason

string

Причина недоступности (если available=false)

Возможные значения поля "unavailable_reason"

Значение Описание Действие

INSUFFICIENT_ACCESS

Нет прав на чтение

Проверить права текущего пользователя

NO_SUCH_OBJECT (not a DNS partition)

Контейнер CN=MicrosoftDNS не создан

Инициализировать partition как DNS

partition not replicated

Партиция не реплицирована

repadmin /syncall /AdeP

Ошибки

Код Причина

401

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

500

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

Обновлено: