大网数据广告活动
Microsoft Graph 接口

Microsoft Graph 的版本控制、支持和重大更改策略

· 52CE 我爱测

了解 Microsoft Graph 的支持和重大更改策略,以及当前可用的 Microsoft Graph API 版本。

本文介绍了 Microsoft Graph 的支持和重大更改策略,以及当前可用的 Microsoft Graph API 版本。

支持策略和弃用信息

Microsoft Graph 遵循 Microsoft 生命周期策略。

由于已发布新版本的 Microsoft Graph REST API 和 Microsoft Graph SDK,之前的版本将停用。 Microsoft 会在停用某个版本之前至少 24 个月声明其为弃用版本。 同样,对于通常可用的 (GA) 单个 API,Microsoft 会在从 GA 版本将其删除之前至少 24 个月时声明其为弃用产品。

递增 API 的主要版本(例如,从 v1.0 到 v2.0)时,我们将通知立即弃用当前版本(在此示例中为 v1.0),在通知 24 个月后,我们将不再支持该版本。出于服务安全或运行状况可靠性问题的考虑,我们可能会对此策略作例外处理。

当 API 被标记为已弃用时,我们强烈建议你尽快迁移到最新版本。 某些情况下,我们将公布新应用程序必须在原始 API 弃用后不久开始使用新的 API。 在这些情况下,仅当前使用已弃用 API 的活动应用程序能够继续使用它们。

API 协定和非后向兼容更改

Microsoft Graph 在版本中进行了许多更改。这些更改已在 Microsoft Graph 更改日志中列出。随着向 Microsoft Graph 中添加新功能和数据,我们将递增 API 版本号,以对 API 进行任意不向后兼容更改。

非后向兼容更改的示例如下:

  • 对与资源关联的 URL 或基本请求/响应进行更改
  • 删除、重命名或更改声明的属性的类型
  • 删除或重命名 API 或 API 参数
  • 添加所需的请求标头

向后兼容的更改示例如下:

  • 添加可为 Null 或具有默认值的属性
  • 向枚举添加成员
  • 删除、重命名或更改开放扩展的类型
  • 删除、重命名或更改注释的类型
  • 向现有集合引入分页
  • 更改错误代码
  • 更改属性的顺序
  • 更改不透明字符串(如资源 ID)的长度或格式

注意: 随着时间的推移,我们将更新向后兼容更改的列表。如果你生成了自己的客户端代理(如 WCF 客户端),我们的建议是,客户端应用程序应准备接收之前未由 Microsoft Graph API 服务定义的属性和派生类型。Microsoft Graph API 遵循 Microsoft REST API 准则的 模型版本控制部分中描述的指导。

版本

以下版本的 Microsoft Graph API 目前可用。

Beta 版

通常,API在 beta 版本中首次亮相,并且可以在 https://graph.microsoft.com/beta 终结点中访问。 如需了解 beta API 文档,请参阅 Microsoft Graph beta 终结点参考。 预计在 beta 版中将会不时对 API 进行重大更改和弃用。 请勿对 beta API 形成生产依赖性。

我们无法保证 beta 功能将升级至当前版本。 当 Microsoft Graph API 团队认为某个 beta 功能可正式发布 (GA) 时,我们将把该功能添加到最新的当前版本中。 如果功能升级将导致当前版本出现重大更改,则版本号将递增,而新版本将成为当前版本。 我们的开发者社区可以在 Microsoft 365 开发者平台创意论坛上发布功能请求,包括对新功能的请求以及将现有的测试 API 升级到当前版本的请求。

当前版本

Microsoft Graph 的当前版本为 v1.0。Microsoft Graph API v1.0 版本在 https://graph.microsoft.com/v1.0 中公开,包含可正式发布和可用于生产的功能。可以浏览 v1.0 API 文档。

预览状态

Microsoft Graph 中的 API 或功能标记为“(预览)”,以指示其行为在 Beta 终结点中是 唯一 的。

v1.0 版本中大多数 API 行为和功能与 Beta 版本相同。 在以下两种情况之一中,“预览”限定了少数 API 和功能:

  • 仅可在 Beta 中使用
  • Beta 版中提供的内容与 v1.0 不同

与 Beta 终结点中的任何其他 API 一样,在文档中标记为“(预览)”的 API 可能会遇到重大更改,恕不另行通知。 请勿从生产应用程序中的 beta 终结点访问 API。

例如,攻击模拟培训是 Microsoft 365 Defender 门户中管理员通常可以使用的一项功能。 当用于攻击模拟培训的 REST API 在 Microsoft Graph 中仅在 Beta 终结点中可用时,REST API 文档将标记为“(预览)”。 “(预览)”标签适用于 Microsoft Graph 中的 REST API 及其文档,即使服务本身通常可用。

已弃用和不支持的版本

目前没有弃用的 Microsoft Graph 版本。

使用条款

使用 Microsoft Graph API 即表示你同意 Microsoft API 使用条款。

你的反馈对我们非常重要。 在 Microsoft Q&A 上联系我们。 使用 [microsoft-graph-*] 标记安全。

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。