API Microsoft Intune Data Warehouse
API Data Warehouse Intune позволяет получить доступ к данным Intune в машиночитаемом формате для использования в любимом инструменте аналитики. API можно использовать для создания отчетов, которые предоставляют аналитические сведения о корпоративной мобильной среде. API использует протокол OData, который соответствует стандартным шаблонам для:
- Заголовки запросов и ответов
- Коды состояния
- Методы HTTP
- Соглашения о URL-адресах
- Типы носителей
- Форматы полезных данных
- Параметры запроса
OData (открытый протокол данных) — это стандарт организации по продвижению стандартов структурированной информации (OASIS), который определяет рекомендации по созданию и использованию API RESTful. Intune Data Warehouse использует OData версии 4.0.
В этом справочном разделе содержатся общие сведения о конечных точках, поддерживаемых методах HTTP, форматах полезных данных возврата и документации по модели данных Data Warehouse Intune.
Важно!
Вы можете опробовать последнюю функциональность Data Warehouse с помощью бета-версии. Чтобы использовать бета-версию, URL-адрес должен содержать параметр api-version=beta
запроса . Бета-версия предлагает функции, прежде чем они становятся общедоступными в качестве поддерживаемой службы. По мере того как Intune добавляет новые функции, бета-версия может изменить поведение и контракты данных. Любой пользовательский код или средства создания отчетов, зависящие от бета-версии, могут завершиться текущими обновлениями.
Настраиваемый клиент OData
Доступ к модели данных Data Warehouse Intune можно получить через конечные точки RESTful. Чтобы получить доступ к данным, клиент должен авторизоваться с помощью Microsoft Entra ID с помощью OAuth 2.0. Сначала вы настраиваете веб-приложение и клиентское приложение в Azure, предоставляя разрешения клиенту. Локальный клиент получает авторизацию и может взаимодействовать с конечными точками Data Warehouse.
Дополнительные сведения см. в статье Получение данных из API Data Warehouse с помощью клиента REST.
Примечание.
Вы можете получить доступ к репозиторию GitHub Intune Data Warehouse на сайте Github для получения примеров кода.
Взаимодействие с API
Для API требуется авторизация с помощью Microsoft Entra ID. Microsoft Entra ID использует OAuth 2.0. После авторизации вы можете получить данные из API, используя команду HTTP GET и связавшись с предоставленными коллекциями сущностей. Дополнительные сведения см. в разделе:
Модель данных Data Warehouse Intune
OData определяет абстрактную модель данных и протокол, которые позволяют любому клиенту получать доступ к информации, предоставляемой любым источником данных. В разделе документации по модели данных содержится описание пространств имен, сущностей и возвращаемых объектов в модели данных Data Warehouse Intune. Дополнительные сведения см. в разделе модель данных Data Warehouse.
Дальнейшие действия
Дополнительные сведения о работе с Microsoft Entra ID см. в статье Сценарии проверки подлинности для Microsoft Entra ID.
Найдите ресурсы OData на odata.org.
Ознакомьтесь со стандартом OData версии 4.0 на странице OData версии 4.0.
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по