Часто задаваемые вопросы об API и службах с лимитным лимитом в Microsoft Graph
В этой статье содержатся ответы на часто задаваемые вопросы о лимитных API и службах в Microsoft Graph.
Вопросы и ответы по настройке выставления счетов
Какие разрешения необходимы для настройки выставления счетов?
Для настройки выставления счетов требуются разрешения как для регистрации приложения, так и для подписки Azure, которую вы хотите использовать. Необходимые разрешения для регистрации приложения: владелец приложения или администратор приложения. Необходимые разрешения для подписки Azure: участник подписки, владелец или участник группы ресурсов или владелец.
Можно ли использовать субъект-службу для настройки выставления счетов при регистрации приложения?
Да, для регистрации приложения, назначенной субъекту-службе, требуется администратор приложения или аналогичная роль. Роль может быть ограничена только целевым приложением, настроенным для выставления счетов, чтобы предотвратить предоставление слишком широких разрешений.
Можно ли использовать управляемое удостоверение для настройки выставления счетов при регистрации приложения?
Да, вы можете создать управляемое удостоверение для ресурсов Azure. Назначьте управление доступом на основе ролей своей подписке или группе ресурсов и добавьте роль администратора приложения Microsoft Entra в субъект-службу, связанный с управляемым удостоверением. Дополнительные сведения см. в статье Руководство. Использование виртуальной машины Или VMSS Windows для доступа к ресурсам Azure .
Как проверить правильность настройки приложения для выставления счетов?
Сведения о проверке настройки выставления счетов см. в статье Включение api и служб с лимитным тарифом.
Часто задаваемые вопросы о выставлении счетов для API экспорта Microsoft Teams
Существуют ли дополнительные требования помимо настройки выставления счетов для вызова API экспорта Microsoft Teams?
Да, api экспорта Microsoft Teams требуют model , чтобы параметр передавался при вызове API. В зависимости от значения параметра для определенных model данных также может потребоваться лицензия пользователя. Дополнительные сведения см. в разделе Модели оплаты API Teams и требования к лицензированию.
Как узнать, какой параметр модели используется в вызовах API?
Лучший способ определить, какой model параметр используется, — проверить код вызывающего приложения.
Как вычисляется начальная емкость?
Заполненная емкость для API экспорта Teams, вызываемых с model=a помощью параметра , вычисляется на основе количества соответствующих пользователей в целевом клиенте. Затем начальная емкость применяется к каждому приложению, работающему в этом клиенте.
Как применяется начальная емкость?
Начальная емкость оценивается в начале месяца, а любая доступная лицензия учитывается в расчете на уровне клиента для заполнения емкости. Затем каждое приложение потребляет начальную емкость, выделенную ему, пока она не будет исчерпана. Затем дальнейшее потребление приложением измеряется и отображается в ежемесячном счете.
Что происходит, когда приложение, зарегистрированное, но не настроенное для выставления счетов, инициирует вызов API экспорта Teams с лимитным лимитом?
Вызов API завершается ошибкой 402. Это происходит даже при выборе пользователя с действующей пользовательской лицензией и передачи model=a параметра .
Что происходит, если параметр модели исключается из вызова API экспорта Microsoft Teams, для чего он требуется?
При вызове API без обязательного model параметра API по умолчанию используется режим оценки. Режим оценки предоставляет ограниченное количество вызовов API в месяц перед возвратом ошибки 402 required payment required. Режим оценки предоставляется только для оценки и разработки и не предназначен для использования в рабочей среде.
Часто задаваемые вопросы о получателе приложения
Почему поставщик приложений просит меня настроить выставление счетов?
Владелец регистрации приложения обрабатывает выставление счетов для API и служб с лимитным тарифом в Microsoft Graph. Если вы приобрели приложение, которое требует, чтобы вы были владельцем регистрации приложения, вы несете ответственность за все api и службы с лимитным лимитом, используемые приложением.
Требуются ли лицензии для каждого пользователя в клиенте?
Лицензия требуется для каждого пользователя, на который распространяется политика безопасности и соответствия требованиям. В других сценариях может не требоваться лицензия. Дополнительные сведения см. в разделе Модели оплаты API Teams и требования к лицензированию.
Вопросы и ответы по управлению затратами и выставлению счетов
Где можно получить сведения о выставлении счетов для API и служб с лимитным тарифом?
Данные выставления счетов передаются в подписку Azure, используемую для создания ресурса выставления счетов Microsoft Graph под именем службы Microsoft Graph, и обычно они доступны через 24 часа после выполнения транзакций.
Дополнительные сведения см. в статье Общие сведения об управлении затратами Azure и выставлении счетов.
В следующей таблице перечислены наиболее часто используемые средства для проверки и мониторинга расходов на выставление счетов.
| Тип | Описание |
|---|---|
| Анализ затрат | Интерактивная диаграмма, отображающая потребление. Подсказка. Используйте накопленные затраты и отфильтруйте службы Microsoft Graph по имени службы. |
| Экспорт | Создает подробные отчеты с требуемой частотой (например, ежедневно или ежемесячно). |
| Оповещения | Настраивает оповещения путем объединения фильтров. |
Счет разбит на каждый API?
В следующей таблице показано, как можно агрегировать или разбить сведения о выставлении счетов.
| Тип | Свойство Exports | Анализ затрат, бюджеты и фильтр оповещений |
|---|---|---|
| Сведения о счетчике | MeterName, MeterId, MeterCategory, MeterSubcategory, ProductName, ConsumedService | Meter, Meter category, Meter subcategory, Service name |
| Сведения о ресурсах | InstanceId, ResourceType, ResourceGroup, SubscriptionGuid | Ресурс, идентификатор ресурса, тип ресурса, группа ресурсов, имя службы |
| Tags | Идентификатор клиента | Идентификатор клиента |
| AdditionalInfo | AppId, TenantId |
Некоторые конечные точки могут совместно использовать метр, и данные выставления счетов не могут быть разбиты по конечным точкам. Кроме того, клиентское приложение может настроить ведение журнала API на стороне клиента или использовать журналы действий Microsoft Graph.
Известные ограничения
К лимитным API применяются следующие ограничения:
- Лимитные API и службы в Microsoft Graph в настоящее время доступны только в глобальной среде Майкрософт, а не в национальных облачных развертываниях, включая развертывания Microsoft 365 GCC, доступные через глобальную конечную точку Microsoft Graph. Дополнительные сведения о национальных облаках см. в статье Развертывание национальных облаков.
- Целевое приложение должно быть конфиденциальным клиентским приложением (например, веб-приложением, веб-API или управляющая программа или служба). Общедоступные клиентские приложения (классические и мобильные приложения) не поддерживаются.
- Управляемые удостоверения Azure не поддерживают вызовы лимитных API. Дополнительные сведения см. в статье Службы Azure, поддерживающие управляемые удостоверения.