Использование API лицензирования облака в Microsoft Graph (предварительная версия)

Важно!

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

Платформа Microsoft Cloud Licensing улучшает управление лицензиями, разбивая лицензии из различных подписок на небольшие управляемые пулы, называемые выделениями. Связь лицензий с их уникальными подписками обеспечивает более детализированный учет и отчетность для организации.

API лицензирования облака определяется в подпространстве microsoft.graph.cloudLicensingимен OData .

Проверка подлинности и разрешения

Microsoft Graph позволяет управлять доступом к ресурсам, используя разрешения. Разработчик должен указать разрешения, необходимые для доступа к ресурсам лицензирования облака. Как правило, разрешения указываются в Центр администрирования Microsoft Entra. Дополнительные сведения см. в статье Справочник по разрешениям Microsoft Graph.

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

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

Вариант использования Ресурсы REST
Вывод списка и получение прав на использование usageRight
Перечисление и получение выделения Выделение
Создание назначений и управление ими Назначения
Устранение ошибок синхронизации назначений assignmentError
Вывод списка и проверка ожидающих участников waitMember

Сведения о проектировании API

В следующих разделах описаны сведения о проектировании API лицензирования облака.

Наделы

Сущность выделения представляет управляемый пул лицензий, связанный с подпиской. Используйте выделения для отслеживания емкости, поддерживаемых служб и подписок, стоящих за этими лицензиями.

Задания

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

Ошибки назначения

Сущность assignmentError вызывает сбои асинхронной синхронизации, влияющие на обработку назначения. Используйте эти API для обнаружения, проверки и устранения неполадок назначений, которые завершили сбой или зависание.

Подписки

Сущность подписки содержит основные сведения о подписке, которая поддерживает выделение, включая даты жизненного цикла и состояние.

Права на использование

Сущность usageRight предназначена для проверок лицензий клиента и рабочей нагрузки с связями, структурированными для передачи от пользователя или группы к usageRight.

Ожидающие члены

Сущность waitMember представляет пользователя или устройство, которое было добавлено в комнату ожидания для выделения из-за ограничений емкости лицензии; он включает время ожидания каждого члена.

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

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