版本設定與支援
本文概述了各種程式設計工具的版本設定和中斷性變更原則。
支援和取代資訊
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 可能會因服務運行狀況和安全問題而對此策略進行例外處理。
對於 PowerShell cmdlet，將提供增量版本來解決較小的錯誤修復。 主要版本將增加以符合出現的新 API 版本。
相容性和中斷性變更
Microsoft 將在發佈計劃中提供可程式設計性更改 的詳細資訊。 如果變更本質上非中斷性變更，則 API 版本將保持不變，而 PowerShell 版本將獲得次要版本增量。 如果更改本質上是中斷性的， Microsoft 將遞增 API 版本和 PowerShell 主要版本。
以下是一些中斷性變更的範例：
- URL 或基本要求/回應已變更。
- 聲明屬性將被刪除或重新命名，或者其類型已更改。
- API 或 API參數會被刪除或重新命名。
- 已新增必要的要求參數。
以下是一些非中斷性變更的範例：
- 新增屬性可以為空或具有預設值。
- 一名成員已新增至列舉。
- 分頁已引入到現有集合物件中。
- 錯誤代碼已變更。
- 要求或回應中的屬性順序已變更。
可用版本
| 版本 | 類型 | 參考 | 取代日期 | 解除日期 |
|---|---|---|---|---|
| 2022-03-01-preview | 公開預覽版 | 2022-03-01-preview 參考 | N/A | 無法使用 |
| 2020-10-01 | 通用 | 2020-10-01 參考文獻 | 無法使用 | 無法使用 |
Note
2020-10-01 Power Platform API 的正式推出版本專用於環境管理，通常也稱為商務應用程式平台 (BAP) API。 這組端點的功能將在較新版本的 Power Platform API 中提供，版本 2022-03-01-preview 之後還有許多附加功能。
後續步驟
現在，您已經了解版本控制和支援策略，接下來讓我們逐步介紹如何使用 Microsoft Power Platform API 驗證。