バージョン管理とサポート
この記事では、さまざまなプログラミング ツールのバージョン管理と破壊的変更ポリシーの概要について説明します。
サポートおよび非推奨情報
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-preview 参照 | 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 で認証する方法を見ていきましょう。