authenticationMethodsRoot: usersRegisteredByMethod

  • Статья

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

Важно!

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

Получение количества пользователей, зарегистрированных для каждого метода проверки подлинности.

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

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

Разрешения

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

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

В делегированных сценариях вызывающий пользователь должен иметь по крайней мере одну из следующих Microsoft Entra ролей:

  • Читатель отчетов
  • Читатель сведений о безопасности
  • Администратор безопасности
  • Глобальный читатель

HTTP-запрос

GET /reports/authenticationMethods/usersRegisteredByMethod

Параметры функции

В приведенной ниже таблице указаны параметры, которые можно использовать с этой функцией.

Параметр Тип Описание
includedUserRoles includedUserRoles Тип роли для пользователя. Возможные значения: all, privilegedAdmin, admin, user.
includedUserTypes includedUserTypes Тип пользователя. Возможные значения: all, member, guest.

Значение privilegedAdmin состоит из следующих Microsoft Entra ролей:

  • Глобальный администратор
  • Администратор безопасности
  • Администратор условного доступа
  • Администратор Exchange
  • Администратор SharePoint
  • Администратор службы поддержки
  • Администратор выставления счетов
  • Администратор пользователей
  • Администратор проверки подлинности

Значение admin включает все Microsoft Entra роли администратора.

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

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

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

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного выполнения эта функция возвращает код отклика 200 OK и userRegistrationMethodSummary в тексте ответа.

Примеры

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/beta/reports/authenticationMethods/usersRegisteredByMethod(includedUserTypes='all',includedUserRoles='all')

Отклик

Ниже показан пример отклика.

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

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

{
  "@odata.type": "#microsoft.graph.userRegistrationMethodSummary",
  "userTypes": "all",
  "userRoles": "all",
  "userRegistrationMethodCounts": [
    {
      "authenticationMethod": "password",
      "userCount": 12209
    },
    {
      "authenticationMethod": "windowsHelloForBusiness",
      "userCount": 223
    },
    {
      "authenticationMethod": "mobilePhone",
      "userCount": 4234
    }
  ]
}