本文概述了各个可编程性工具的版本控制和中断性变更策略。
支持和弃用信息
随着新版本的 REST API 发布，早期版本将停用。 Microsoft声明在停用 API 终结点之前至少 12 个月弃用的版本。 当版本弃用时，as-is支持它。 如果遇到该版本的问题，我们请求你迁移到当前稳定的版本。 停用某个版本后，它不受支持，并且即将关闭。
通过递增 API 的版本号（例如，从 2021-10-01 到 2022-04-01）， Microsoft 宣布以前的正式发布版本（在本例中为 2021-10-01）将立即弃用，并将在公告 12 个月后停用。 公开预览版的处理方式相同。 Microsoft 可能会对服务 HEalth 和安全问题对此策略进行例外处理。
基于 Power Platform API（如 Power Platform CLI、管理 V2 连接器和 PowerShell）生成的各种工具和 SDK 会根据每个作更新到更新的 API 版本，并且对最终用户是透明的。
兼容和中断性变更
Microsoft提供有关 发布计划中可编程性更改的详细信息。 如果更改本质上是非中断性的，API 版本保持不变，并且 PowerShell 版本收到次要版本增量。 如果更改在本质上中断，Microsoft会递增 API 版本和 PowerShell 主版本。
以下是中断性变更的示例：
- URL 或基本请求/响应发生更改。
- 声明的属性被删除或重命名，或者其类型发生更改。
- API 或 API 参数被删除或重命名。
- 添加了必需的请求参数。
下面是非中断性变更的示例：
- 添加的属性是可为空属性或具有默认值。
- 向枚举添加了成员。
- 现有集合中引入了分页。
- 错误代码发生更改。
- 请求或响应中的属性顺序发生更改。
可用版本
| 版本 | 类型 | 参考 | 弃用日期 | 取消日期 |
|---|---|---|---|---|
| 2024-10-01 | 稳定 | 引用 | 不适用 | 不适用 |
| 2022-03-01-preview | 公开预览版 | 2022-03-01-preview 参考 | 2025-03-01 | 2026-03-01 |
| 2020-10-01 | 正式发布 | 2020-10-01 参考文献 | 不适用 | 不适用 |
备注
Power Platform API 的 2020-10-01 正式发布版本特定于环境管理，通常也称为业务应用程序平台 (BAP) API。 在较新版本的 Power Platform API 中提供了这组终结点的功能，以及版本 2022-03-01-preview 之后的许多其他功能。
后续步骤
现在，您了解了版本控制和支持策略，我们来逐步介绍一下如何使用 Microsoft Power Platform API 进行身份验证。