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

Использование API управления конфигурацией клиента в Microsoft Graph

Важно!

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

API-интерфейсы управления конфигурацией клиента (TCM) позволяют администраторам управлять параметрами конфигурации для одной или нескольких рабочих нагрузок в организации.

Api конфигурации клиента должны, чтобы администраторы сначала добавили субъект-службу TCM в свой клиент, а затем предоставили ему разрешения. Это предварительный шаг. Дополнительные сведения см. в статье Настройка проверки подлинности для API управления конфигурацией клиента.

Авторизация

Чтобы вызвать API TCM в Microsoft Graph, приложению необходимо получить маркер доступа. Подробные сведения о маркерах доступа см. в статье Получение маркеров доступа для вызова Microsoft Graph. Приложению также требуются соответствующие разрешения. Дополнительные сведения см. в статье Справочник по разрешениям Microsoft Graph.

API мониторинга клиента

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

API моментальных снимков

API snapshot в TCM позволяют администраторам извлекать текущие параметры конфигурации клиента. Этот процесс позволяет администраторам получить базовые показатели, которые представляют нужную конфигурацию клиента и служат основой для периодического мониторинга клиентов.

Основные варианты использования

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

Вариант использования Ресурс REST См. также
Получение базового плана и создание задания snapshot configurationBaseline Методы configurationBaseline
Вывод списка и получение смещения configurationDrift Методы configurationDrift
Создание мониторов и управление ими configurationMonitor Методы configurationMonitor
Вывод списка и получение результатов мониторинга configurationMonitoringResult Методы configurationMonitoringResult
Перечисление, получение и удаление заданий snapshot configurationSnapshotJob Методы configurationSnapshotJob

Ограничения API

Мониторинг клиента

К API configurationMonitor применяются следующие ограничения API:

  • Для каждого клиента можно создать до 30 объектов configurationMonitor .
  • Каждый элемент configurationMonitor выполняется с фиксированным интервалом в шесть часов. Монитор нельзя настроить для выполнения с любой другой частотой.
  • Администратор может отслеживать до 800 ресурсов конфигурации в день для каждого клиента на всех мониторах. Администраторы решают, как использовать эту квоту— с помощью одного или нескольких мониторов. Пример. Если администратор включает 20 правил транспорта и 30 политик условного доступа в базовые показатели монитора, он отслеживает 50 ресурсов за цикл. Так как монитор работает каждые шесть часов (4 цикла в день), это приводит к 200 отслеживаемых ресурсов в день. Дополнительные мониторы можно создавать до тех пор, пока не будет достигнуто ежедневное ограничение в 800 ресурсов .
  • Когда администратор обновляет базовые показатели существующего монитора, все ранее созданные результаты мониторинга и обнаруженные смещения для этого монитора автоматически удаляются.

Заносы

К API configurationDrift применяются следующие ограничения API:

  • Все активные смещения сохраняются и доступны администраторам для проверки в любое время.
  • Каждый фиксированный смещение удаляется через 30 дней после его разрешения.

Снимок

К API configurationSnapshotJob API применяются следующие ограничения API:

  • Вы можете извлекать не более 20 000 ресурсов для каждого клиента в месяц. Это совокупное ограничение для всех моментальных снимков.
  • Максимальное количество моментальных снимков, которые можно создать в день или месяц, не существует. Вы можете создать столько моментальных снимков, сколько необходимо, при условии, что общее количество извлеченных ресурсов остается в пределах ежемесячной квоты на 20 000 ресурсов для клиента.
  • Администратору доступно не более 12 snapshot заданий. Если администратор хочет создать больше snapshot заданий, ему нужно удалить одно или несколько существующих заданий.
  • Snapshot хранится не более семи дней, после чего автоматически удаляется.

Дальнейшие действия

Используйте API TCM Microsoft Graph для управления параметрами конфигурации в одной или нескольких рабочих нагрузках в организации. Чтобы узнать больше:

  • Изучите ресурсы и методы, наиболее полезные для вашего сценария.
  • опробуйте API в песочнице Graph.

Связанные материалы

Обзор API управления конфигурацией клиента в Microsoft Graph

Настройка проверки подлинности для API управления конфигурацией клиента

  • Last updated on