この記事では、さまざまなプログラミング ツールのバージョン管理と破壊的変更ポリシーの概要について説明します。
サポートおよび非推奨情報
REST API の新しいバージョンがリリースされると、以前のバージョンは廃止されます。 Microsoft では、API エンドポイントを廃止する少なくとも 12 か月前に非推奨となったバージョンを宣言しています。 バージョンが非推奨になると、as-isサポートされます。 そのバージョンで問題が発生した場合は、現在安定しているバージョンに移行するようお願いします。 バージョンが廃止されると、サポートされず、間もなくシャットダウンされます。
APIのバージョン番号を増やす (たとえば、2021-10-01から2022-04-01に) ことで、 Microsoft 以前の一般提供バージョン (この例では2021-10-01) が直ちに非推奨となり、発表から12か月後に廃止されることが発表されます。 パブリック プレビュー バージョンも同じ扱いを受けます。 Microsoft サービスの健全性とセキュリティの問題により、このポリシーに例外を設ける場合があります。
Power Platform CLI、Admin V2 コネクタ、PowerShell など、Power Platform API の上に生成されるさまざまなツールと SDK は、アクションごとに新しい API バージョンに更新され、エンド ユーザーには透過的です。
互換性のある破壊的変更
Microsoft では、 リリース 計画におけるプログラミングの変更の詳細を提供します。 変更が本質的に壊れない場合、API のバージョンは変わらず、PowerShell バージョンはマイナー バージョンの増分を受け取ります。 変更が本質的に壊れている場合、Microsoft は API バージョンと PowerShell メジャー バージョンをインクリメントします。
破壊的変更の例を、次に示します。
- URL または基本的な要求/応答が変更される。
- 宣言されたプロパティが削除または名前を変更されるか、そのタイプが変更される。
- API または API パラメーターが削除されるか、名前が変更される。
- 必要な要求パラメーターが追加される。
改行しない変更の例を次に示します。
- Null 値が許容される、または既定値を持つプロパティが追加される。
- メンバーが列挙に追加される。
- ページングが既存のコレクションに導入される。
- エラー コードが変更される。
- 要求または応答のプロパティの順序が変更される。
利用できるバージョン
| バージョン | タイプ | 参照 | 非推奨日 | 停止日 |
|---|---|---|---|---|
| 2024-10-01 | 安定 | リファレンス | N/A | N/A |
| 2022-03-01-preview | パブリック プレビュー | 2022-03-01-プレビュー 参照 | 2025-03-01 | 2026-03-01 |
| 2020-10-01 | 一般に入手可能 | 2020-10-01参照 | N/A | N/A |
Note
2020-10-01 の一般提供バージョンの Power Platform API は環境管理に固有であり、一般にビジネス アプリケーション プラットフォーム (BAP) API とも呼ばれます。 この一連のエンドポイントの機能は、新しいバージョンの Power Platform API と、バージョン 2022-03-01-preview 以降の多くの追加機能で利用できます。
次のステップ
バージョン管理とサポート戦略について理解できたので、Microsoft Power Platform API で認証する方法を見ていきましょう。