Получение azureADAuthentication

  • Статья

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

Важно!

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

Ознакомьтесь со свойствами и связями объекта azureADAuthentication, чтобы найти уровень доступности Microsoft Entra проверки подлинности для клиента. Соглашение об уровне обслуживания (SLA) Microsoft Entra фиксирует доступность проверки подлинности не менее 99,99 %, как описано в разделе Microsoft Entra производительности соглашения об уровне обслуживания. Этот объект обеспечивает фактическую производительность вашего клиента по отношению к этому обязательству.

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

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

Разрешения

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

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

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

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

HTTP-запрос

GET /reports/sla/azureADAuthentication

Необязательные параметры запросов

Этот метод не принимает никаких параметров.

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

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

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

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

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и объект azureADAuthentication в теле отклика. Каждое возвращаемое значение содержит оценку, показывающую процент доступности проверки подлинности клиента за месяц, а также startDate и endDate, указывающие месяц, которому назначен процент доступности.

Примеры

Запрос

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

GET https://graph.microsoft.com/beta/reports/sla/azureADAuthentication

Отклик

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

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

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#reports/sla/azureADAuthentication/$entity",
    "attainments": [
        {
            "startDate": "2023-05-01",
            "endDate": "2023-05-31",
            "score": 99.999
        },
        {
            "startDate": "2023-04-01",
            "endDate": "2023-04-30",
            "score": 99.999
        },
        {
            "startDate": "2023-03-01",
            "endDate": "2023-03-31",
            "score": 99.999
        },
        {
            "startDate": "2023-02-01",
            "endDate": "2023-02-28",
            "score": 99.999
        },
        {
            "startDate": "2023-01-01",
            "endDate": "2023-01-31",
            "score": 99.998
        },
        {
            "startDate": "2022-12-01",
            "endDate": "2022-12-31",
            "score": 99.999
        },
    ]
}