Поделиться через

domain: verify

  • Статья

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Проверьте владение доменом.

Важный: Применяется только к непроверенным доменам. Для непроверенного домена свойство isVerified домена имеет значение false.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ✅

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) Domain.ReadWrite.All Недоступно.
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Для приложений Domain.ReadWrite.All Недоступно.

Рабочая или учебная учетная запись должна принадлежать по крайней мере роли "Администратор доменных имен" Microsoft Entra.

HTTP-запрос

POST /domains/{id}/verify

В качестве параметра {id} укажите домен, используя его полное доменное имя.

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json

Текст запроса

В тексте запроса укажите представление параметров в формате JSON.

В следующей таблице перечислены параметры, которые являются необязательными при вызове этого действия.

Параметр Тип Описание
forceTakeover Boolean Необязательное свойство. Используется для поглощения неуправляемого домена внешним администратором. Значение по умолчанию для этого параметра — false.

Если проверяемый домен в настоящее время связан с неуправляемым клиентом, но вы являетесь владельцем домена, используйте этот параметр, чтобы перехватить этот домен. Принудительное переключение выполняется успешно, только если этот клиент подтвердил владение доменом, добавив записи TXT к регистратору доменов. Дополнительные сведения см. в статье Управление неуправляемым каталогом в качестве администратора в Microsoft Entra ID.

Отклик

При успешном выполнении этот метод возвращает код отклика 200 OK и объект domain в теле отклика.

Пример 1. Проверка домена

Запрос

POST https://graph.microsoft.com/beta/domains/contoso.com/verify

Отклик

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-type: application/json

{
  "authenticationType": "authenticationType-value",
  "availabilityStatus": "availabilityStatus-value",
  "isAdminManaged": true,
  "isDefault": true,
  "isInitial": true,
  "isRoot": true,
  "name": "contoso.com"
}

Пример 2. Поглощение домена внешним администратором

Запрос

POST https://graph.microsoft.com/beta/domains/contoso.com/verify

{
  "forceTakeover": true
}

Отклик

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-type: application/json

{
  "authenticationType": "authenticationType-value",
  "availabilityStatus": "availabilityStatus-value",
  "isAdminManaged": true,
  "isDefault": true,
  "isInitial": true,
  "isRoot": true,
  "name": "contoso.com",
  "isVerified": true
}