Конечная точка API Intune Data Warehouse

API Intune Data Warehouse можно использовать с учетной записью с определенными элементами управления доступом на основе ролей и Microsoft Entra учетными данными. Затем вы авторизуете клиент REST с помощью Microsoft Entra ID с помощью OAuth 2.0. И, наконец, вы создайте понятный URL-адрес для вызова ресурса хранилища данных.

требования к Microsoft Entra ID и Intune учетным данным

Проверка подлинности и авторизация основаны на учетных данных Microsoft Entra и Intune управлении доступом на основе ролей (RBAC). Все администраторы Intune клиента имеют доступ к хранилищу данных по умолчанию. Используйте Intune роли, чтобы предоставить доступ к ресурсу хранилища данных Intune для большего количество пользователей.

Ниже приведены требования для доступа к Intune Data Warehouse (включая API).

Важно!

Чтобы назначить роль Intune и получить доступ к Intune Data Warehouse, пользователь должен иметь лицензию на Intune. Дополнительные сведения см. в статье Управление доступом на основе ролей (RBAC) с Microsoft Intune и лицензированием Microsoft Intune.

Авторизация

Microsoft Entra ID использует OAuth 2.0 для авторизации доступа к веб-приложениям и веб-API в клиенте Microsoft Entra. Это руководство не зависит от языка и описывает, как отправлять и получать HTTP-сообщения без использования библиотек с открытым кодом. Поток кода авторизации OAuth 2.0 описан в разделе 4.1 спецификации OAuth 2.0.

Дополнительные сведения см. в статье Авторизация доступа к веб-приложениям с помощью OAuth 2.0 и Microsoft Entra ID.

Структура URL-адреса API

Конечные точки API Data Warehouse считывают сущности для каждого набора. API поддерживает HTTP-команду GET и подмножество параметров запроса.

URL-адрес для Intune имеет следующий формат:https://fef.{location}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity-collection}?api-version={api-version}

Примечание.

В приведенном выше URL-адресе замените {location}, {entity-collection}и {api-version} на основе сведений, указанных в таблице ниже.

URL-адрес содержит следующие элементы:

Элемент Пример Описание
расположение msua06 Базовый URL-адрес можно найти, просмотрев колонку API Data Warehouse в Центре администрирования Microsoft Intune.
коллекция сущностей devicePropertyHistories Имя коллекции сущностей OData. Дополнительные сведения о коллекциях и сущностях в модели данных см. в разделе Модель данных.
версия api Бета Версия — это версия API для доступа. Дополнительные сведения см. в разделе Версия.
maxhistorydays 7 (Необязательно) Максимальное количество дней для извлечения журнала. Этот параметр можно предоставить любой коллекции, но он вступит в силу только для коллекций, включающих dateKey в себя как часть свойства ключа. Дополнительные сведения см. в разделе Фильтры диапазона DateKey .

Сведения о версии API

Теперь вы можете использовать версию 1.0 Intune Data Warehouse, задав параметр api-version=v1.0запроса . Обновления к коллекциям в Data Warehouse являются аддитивными по своей природе и не нарушают существующие сценарии.

Вы можете опробовать последнюю функциональность Data Warehouse с помощью бета-версии. Чтобы использовать бета-версию, URL-адрес должен содержать параметр api-version=betaзапроса . Бета-версия предлагает функции, прежде чем они становятся общедоступными в качестве поддерживаемой службы. По мере того как Intune добавлены новые функции, бета-версия может изменить поведение и контракты данных. Любой пользовательский код или средства создания отчетов, зависящие от бета-версии, могут завершиться текущими обновлениями.

Параметры запроса OData

Текущая версия поддерживает следующие параметры запроса OData: $filter, $selectи $skip,$top. В $filterможет поддерживаться только DateKey или RowLastModifiedDateTimeUTC , если столбцы применимы, а другие свойства вызывают недопустимый запрос.

Фильтры диапазона DateKey

DateKey Фильтры диапазонов можно использовать для ограничения объема данных для скачивания для некоторых коллекций с dateKey в качестве ключевого свойства. Фильтр DateKey можно использовать для оптимизации производительности службы, указав следующий $filter параметр запроса:

  1. DateKey только в $filter, поддерживая lt/le/eq/ge/gt операторы и объединяя их с оператором andлогики , где они могут быть сопоставлены с датой начала и (или) датой окончания.
  2. maxhistorydays предоставляется в качестве параметра пользовательского запроса.

Примеры фильтрации

Примечание.

Примеры фильтра предполагают, что сегодня это 21.02.2018.

Filter Оптимизация производительности Описание
maxhistorydays=7 Full Возвращает данные в диапазоне DateKey от 20180214 до 20180221.
$filter=DateKey eq 20180214 Full Возвращает данные, равные DateKey 20180214.
$filter=DateKey ge 20180214 and DateKey lt 20180221 Full Возвращает данные в диапазоне DateKey от 20180214 до 20180220.
maxhistorydays=7&$filter=DateKey eq 20180214 Full Возвращает данные, равные DateKey 20180214. maxhistorydays игнорируется.
$filter=RowLastModifiedDateTimeUTC ge 2018-02-21T23:18:51.3277273Z Full Возвращает данные с RowLastModifiedDateTimeUTC значением больше или равно 2018-02-21T23:18:51.3277273Z
  • Last updated on