本文概述了各个可编程性工具的版本控制和中断性变更策略。
支持和弃用信息
Power Platform API 是在 PowerShell、管理连接器和 Power Platform CLI 等其他 SDK 之前第一个接收新版本和新功能的可编程工具。 随着新版本 REST API 的发布，早期版本将停用。 Microsoft 将在停用 API 终结点之前至少 12 个月声明版本已弃用。 当某个版本被弃用时，它仍然按原样受支持。 如果您在使用该版本时遇到问题，我们将要求您迁移到当前正式发布的版本。 当版本停用时，它不再受支持，很快会被关闭。
通过递增 API 的版本号（例如，从 2021-10-01 到 2022-04-01）， Microsoft 宣布以前的正式发布版本（在本例中为 2021-10-01）将立即弃用，并将在公告 12 个月后停用。 公开预览版的处理方式相同。 Microsoft 可能会对服务 HEalth 和安全问题对此策略进行例外处理。
对于 PowerShell cmdlet，将提供增量版本来解决较小的 bug 修复。 主要版本将递增以匹配出现的新 API 版本。
兼容和中断性变更
Microsoft 将在发布计划中提供可编程性更改 的详细信息。 如果更改本质上是非中断的，API 版本将保持不变，PowerShell 版本在次要版上将递增。 如果更改本质上是中断性的， Microsoft 将递增 API 版本和 PowerShell 主要版本。
以下是中断性变更的示例：
- URL 或基本请求/响应发生更改。
- 声明的属性被删除或重命名，或者其类型发生更改。
- API 或 API 参数被删除或重命名。
- 添加了必需的请求参数。
以下是非中断性变更的示例：
- 添加的属性是可为空属性或具有默认值。
- 向枚举添加了成员。
- 现有集合中引入了分页。
- 错误代码发生更改。
- 请求或响应中的属性顺序发生更改。
可用版本
| 版本 | 类型 | 参考 | 弃用日期 | 取消日期 |
|---|---|---|---|---|
| 2022-03-01-preview | 公开预览版 | 2022-03-01-preview 参考 | 不适用 | 不可用 |
| 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 进行身份验证。