Обзор лимитных API и служб в Microsoft Graph

  • Статья

Microsoft Graph включает API- интерфейсы, доступные без дополнительных затрат с лицензиями на подписку пользователей , а также API и службами с лимитным лимитом. Лимитные API и службы в Microsoft Graph влечет за собой затраты в зависимости от использования. Затраты могут быть связаны с вызовом API, объектом, возвращенным в вызове API, или с помощью других мер.

Независимо от того, задано ли лимит, API в Microsoft Graph следуют следующим двум принципам:

Измерение некоторых API помогает обеспечить работоспособность текущей и будущей экосистемы Microsoft Graph, балансируя доступ к платформе и затраты. В случае, если API Graph Майкрософт, включенный в лицензии на подписку пользователей, станет лимитным, это будет не обратно совместимое изменение, а также применяются политики управления версиями, поддержки и критических изменений для Microsoft Graph.

Список api и служб с лимитным лимитом см. в разделе Лимитные API и службы.

Категории API и измерение

API Microsoft Graph делятся на три категории, и измерение может применяться в зависимости от категории API.

Стандартные API

Большинство API Microsoft Graph являются стандартными API. Эти API выполняют стандартные операции (создание, чтение, обновление, удаление) для содержимого клиента и административных конечных точек. Разумные ограничения доступа для этих API определяются на основе задокументированных пороговых значений использования. Это помогает обеспечить положительное взаимодействие с клиентами и способствует эффективному использованию API. Доступ к стандартным API в пределах определенных пороговых значений использования предоставляется в рамках пользовательской лицензии без дополнительных затрат.

API высокой емкости

API высокой емкости обеспечивают клиентам и разработчикам доступ к данным в большом масштабе. К этой категории относятся специализированные конечные точки массового экспорта или импорта и службы Microsoft Graph. Эти API могут быть лимитированы и нести дополнительные затраты, помимо лицензий на подписку пользователей.

Расширенные API

Расширенные API предоставляют доступ к расширенным или агрегированным данным или расширенным функциям, которые можно использовать в Microsoft 365. API assignSensitivityLabel является примером расширенного API. Эти API могут быть лимитированы и нести дополнительные затраты, помимо лицензий на подписку пользователей.

Доступ к API с лимитным лимитом

Для доступа к лимитным API и службам в Microsoft Graph приложение должно быть связано с активной подпиской Microsoft Azure. Дополнительные сведения о том, как связать приложение с подпиской, см . в статье Включение лимитных API и служб в Microsoft Graph.

Рекомендации по использованию лимитных API

При использовании лимитных API и служб в Microsoft Graph учитывайте следующие аспекты:

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

Известные ограничения

К лимитным API применяются следующие ограничения:

  • Лимитные API и службы в Microsoft Graph в настоящее время доступны только в глобальной среде Майкрософт, а не в национальных облачных развертываниях, включая развертывания Microsoft 365 GCC, доступные через глобальную конечную точку Microsoft Graph. Дополнительные сведения о национальных облаках см. в статье Развертывание национальных облаков.
  • Целевое приложение должно быть конфиденциальным клиентским приложением (например, веб-приложением, веб-API или управляющая программа или служба). Общедоступные клиентские приложения (классические и мобильные приложения) не поддерживаются.

Связанные материалы