Конечная точка API хранилища данных Intune

Статья
11/19/2024

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
- Проверка подлинности без пользователей с использованием проверки подлинности только для приложений

Важно!

Чтобы назначить роль 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 параметр запроса:

DateKey только в $filter, поддерживая lt/le/eq/ge/gt операторы и объединяя их с оператором andлогики , где они могут быть сопоставлены с датой начала и (или) датой окончания.
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`

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