バージョン管理とサポート
この記事では、さまざまなプログラミング ツールのバージョン管理と破壊的変更ポリシーの概要について説明します。
サポートおよび非推奨情報
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 コマンドレットの場合、軽微なバグ修正を解決するための増分バージョンが使用可能になります。 メジャー バージョンは、発生する新しい API バージョンに一致するようにインクリメントされます。
互換性のある破壊的変更
Microsoft リリース計画では、プログラミングの変更の詳細が提供されます 。 本質的な破壊的変更ではない場合、API バージョンは変わらず、PowerShell バージョンはマイナー バージョン増分を受け取ります。 変更が本質的に破壊的なものである場合、 Microsoft APIバージョンとPowerShellメジャー バージョンが増加します。
破壊的変更の例を、次に示します。
- URL または基本的な要求/応答が変更される。
- 宣言されたプロパティが削除または名前を変更されるか、そのタイプが変更される。
- API または API パラメーターが削除されるか、名前が変更される。
- 必要な要求パラメーターが追加される。
破壊的変更ではない例を、次に示します。
- Null 値が許容される、または既定値を持つプロパティが追加される。
- メンバーが列挙に追加される。
- ページングが既存のコレクションに導入される。
- エラー コードが変更される。
- 要求または応答のプロパティの順序が変更される。
利用できるバージョン
| バージョン | タイプ | 参照 | 非推奨日 | 停止日 |
|---|---|---|---|---|
| 2022-03-01-preview | パブリック プレビュー | 2022-03-01-プレビュー 参照 | N/A | N/A |
| 2020-10-01 | 一般に入手可能 | 2020-10-01参照 | N/A | N/A |
Note
2020-10-01 の一般提供バージョンの Power Platform API は環境管理に固有であり、一般にビジネス アプリケーション プラットフォーム (BAP) API とも呼ばれます。 この一連のエンドポイントの機能は、Power Platform の新しいバージョンで利用できるようになり、バージョン 2022-03-01-preview 以降の多くの追加機能に併せてご利用いただけます。
次のステップ
バージョン管理とサポート戦略について理解できたので、Microsoft Power Platform API で認証する方法を見ていきましょう。