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

API хранилища данных Microsoft Intune

  • Статья

API хранилища данных Intune позволяет получить доступ к данным Intune в машиночитаемом формате для использования в любимом средстве аналитики. API можно использовать для создания отчетов, которые предоставляют аналитические сведения о корпоративной мобильной среде. API использует протокол OData, который соответствует стандартным шаблонам для:

  • Заголовки запросов и ответов
  • Коды состояния
  • Методы HTTP
  • Соглашения о URL-адресах
  • Типы носителей
  • Форматы полезных данных
  • Параметры запроса

OData (открытый протокол данных) — это стандарт организации по продвижению стандартов структурированной информации (OASIS), который определяет рекомендации по созданию и использованию API RESTful. Хранилище данных Intune использует OData версии 4.0.

В этом разделе приведены общие сведения о конечных точках, поддерживаемых методах HTTP, форматах возвращаемых полезных данных и документации по модели данных хранилища данных Intune.

Важно!

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

Настраиваемый клиент OData

Вы можете получить доступ к модели данных хранилища данных Intune через конечные точки RESTful. Чтобы получить доступ к данным, клиент должен авторизоваться с помощью Идентификатора Microsoft Entra с помощью OAuth 2.0. Сначала вы настраиваете веб-приложение и клиентское приложение в Azure, предоставляя разрешения клиенту. Локальный клиент получает авторизацию и может взаимодействовать с конечными точками хранилища данных.

Дополнительные сведения см. в статье Получение данных из API хранилища данных с помощью клиента REST.

Примечание.

Вы можете получить доступ к репозиторию хранилища данных GitHub Intune на сайте GitHub для получения примеров кода.

Взаимодействие с API

Для API требуется авторизация с идентификатором Microsoft Entra. Идентификатор Microsoft Entra использует OAuth 2.0. После авторизации вы можете получить данные из API, используя команду HTTP GET и связавшись с предоставленными коллекциями сущностей. Дополнительные сведения см. в разделе:

Модель данных хранилища данных Intune

OData определяет абстрактную модель данных и протокол, которые позволяют любому клиенту получать доступ к информации, предоставляемой любым источником данных. В разделе документации по модели данных содержится описание пространств имен, сущностей и возвращаемых объектов в модели данных хранилища данных Intune. Дополнительные сведения см. в разделе Модель данных хранилища данных.

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

Дополнительные сведения о работе с Идентификатором Microsoft Entra см. в статье Сценарии проверки подлинности для Идентификатора Microsoft Entra.

Найдите ресурсы OData на odata.org.

Ознакомьтесь со стандартом OData версии 4.0 на странице OData версии 4.0.