Microsoft Graph 中按流量计费的 API 和服务概述

Microsoft Graph 包括无需额外付费的 API,以及按流量计费 的用户订阅许可证 以及 API 和服务。 Microsoft Graph 中的按流量计费的 API 和服务会根据使用情况产生成本。 每个 API 调用、API 调用中返回的每个对象或其他度量值可能会产生成本。

无论是否按流量计费,Microsoft Graph 中的 API 都遵循以下两个原则:

通过平衡平台访问和成本,对某些 API 进行计量有助于确保当前和未来的 Microsoft Graph 生态系统的运行状况。 如果用户订阅许可证附带的 Microsoft Graph API 按流量计费,则这是非向后兼容的更改 ,并且将应用 Microsoft Graph 的版本控制、支持和中断性变更策略

有关按流量计费的 API 和服务的列表,请参阅 按流量计费的 API 和服务

API 类别和计量

Microsoft Graph API 分为三类,计量可能基于 API 的类别应用。

标准 API

大多数Microsoft图形 API 都是标准 API。 这些 API 执行标准操作, (在客户内容和管理终结点上创建、读取、更新、删除) 。 这些 API 的合理访问限制是根据记录 的使用阈值定义的。 这有助于确保积极的客户体验,并鼓励有效的 API 使用模式。 在定义的使用阈值内访问标准 API 作为用户许可证的一部分,无需额外付费。

高容量 API

高容量 API 可确保客户和开发人员能够大规模访问数据。 此类别包括专用的批量导出或导入终结点以及Microsoft Graph 服务。 这些 API 可能会按流量计费,并产生超出用户订阅许可证的额外费用。

高级 API

高级 API 提供对扩充或聚合数据的访问权限,或者从 Microsoft 365 扩展的高级功能。 assignSensitivityLabel API 是高级 API 的示例。 这些 API 可能会按流量计费,并产生超出用户订阅许可证的额外费用。

访问按流量计费的 API

若要在 Microsoft Graph 中访问按流量计费的 API 和服务,必须将应用程序与活动Microsoft Azure 订阅相关联。 有关如何将应用关联到订阅的详细信息,请参阅 在 Microsoft Graph 中启用按流量计费的 API 和服务

使用按流量计费的 API 的注意事项

在 Microsoft Graph 中使用按流量计费的 API 和服务时,请记住以下注意事项:

  • 除其他常见错误外,按流量计费的 API 还可以返回与订阅状态相关的错误。 有关Microsoft Graph 错误的详细信息,请参阅 Microsoft Graph 错误和资源类型
  • 按流量计费的 API 根据 API 使用情况计费。 请务必了解计量单位,以便可以估算与特定 API 关联的成本。

已知限制

以下限制适用于按流量计费的 API:

  • Microsoft Graph 中的按流量计费的 API 和服务目前仅适用于Microsoft全球环境,而不适用于国家云部署,包括通过全球 Microsoft Graph 终结点访问的 Microsoft 365 个 GCC 部署。 有关国家云的详细信息,请参阅 国家云部署
  • 目标应用程序必须是机密客户端应用程序, (例如 Web 应用程序、Web API 或守护程序/服务) 。 不支持公共客户端应用程序 (桌面和移动应用程序) 。
  • 不支持 Azure 托管标识调用按流量计费的 API。 有关详细信息,请参阅 支持托管标识的 Azure 服务