次の方法で共有

Microsoft Graph のバージョン管理、サポートと重大な変更の方針

  • [アーティクル]

この記事は Microsoft Graph のサポート重大な変更の方針と、現在使用可能な Microsoft Graph API のバージョンについて説明します。

サポート ポリシーと廃止の情報

Microsoft Graph は Microsoft ライフサイクル ポリシーに従います。

Microsoft Graph REST API の新しいバージョンがリリースされると、以前のバージョンは廃止されます。 Microsoft は、バージョンを廃止する少なくとも 24 か月前に非推奨として宣言します。 同様に、一般提供 (GA) に達した個々の API の場合、Microsoft は、API を GA バージョンから削除する少なくとも 24 か月前に非推奨として宣言します。

Microsoft Graph SDK では、特定のライブラリの最新のメジャー バージョンのみがサポートされ、新機能、バグ修正、回避策で更新されます。 最新バージョンより前のメジャー バージョンは、セキュリティ修正でのみ、最新のメジャー バージョンのリリース日から 12 か月間サポートされます。 可能な限り、最新バージョンの SDK にアップグレードすることをお勧めします。

API のメジャー バージョン (たとえば、v1.0 から v2.0) をインクリメントすると、現在のバージョン (この例では v1.0) が直ちに非推奨となり、発表から 24 か月後にサポートされなくなります。 サービスのセキュリティと信頼性向上のためにこのポリシーを変更することがあります。

API が非推奨と指定された場合、できるだけ早く最新バージョンへ移行することを強くお勧めします。 場合によっては、元の API が非推奨になった直後に、新しいアプリケーションで新しい API の使用を開始する必要があることをお知らせします。 そのような場合、現在非推奨 APIを使用しているアクティブなアプリケーションのみが使用し続けることができます。

API コントラクトと非バックワード互換性の変更

Microsoft Graph にはバージョン更新の変更履歴があります。 これらの変更は、 Microsoft Graph の変更ログに一覧表示されます。 新しい機能とデータが Microsoft Graph に追加されると、API に対するバックワード互換性のない変更に対して API バージョン番号がインクリメントされます。

非バックワード互換性の変更の例を次に示します。

  • URL またはリソースに関する基本的な要求や応答の変更
  • 宣言済みプロパティの型の削除、変更と、その名前の変更
  • API と API パラメーターの削除または名前の変更
  • 必須の要求ヘッダーの追加

次に、下位互換性のある変更の例を示します。

  • Null 許容型プロパティや既定値を持つプロパティの追加
  • 列挙型へのメンバーの追加
  • オープン拡張情報の削除、変更と、その名前の変更
  • 注釈の削除、変更と、その名前の変更
  • 既存のコレクションへのページングの導入
  • エラー コードの変更
  • プロパティの順序の変更
  • リソース ID のような不透明な文字列の長さまたは形式の変更

メモ： 時間の経過と同時に、下位互換性のある変更の一覧を更新します。 独自のクライアント プロクシ (WCF クライアントなど) を作成する場合、ガイドラインとしては Microsoft Graph API サービスにあらかじめ定義されていないプロパティや派生型をクライアント アプリケーションが受け入れることができるように準備してください。 Microsoft Graph API は「Microsoft REST API ガイドライン」の「バージョン管理のモデル」セクションの説明に従っています。

バージョン

現在、以下のバージョンの Microsoft Graph API が使用できます。

ベータ版

一般に、API はベータ版でデビューし、https://graph.microsoft.com/beta エンドポイントでアクセスできます。 ベータ版 API のドキュメントは、「Microsoft Graph ベータ エンドポイント リファレンス」を参照してください。 ベータ版には随時 API の重大な変更と廃止が発生することがあります。 ベータ API に運用環境の依存関係を設定しないでください。

ベータ版の機能が現行バージョンに採用される保証はありません。 Microsoft Graph API チームがベータ機能を一般提供の準備ができていると判断した場合は、その機能を最新バージョンに追加します。 機能の昇格によって現在のバージョンに破壊的変更が発生する場合は、バージョン番号がインクリメントされ、新しいバージョンが現在のバージョンになります。

現在のバージョン

Microsoft Graph の現在のバージョンは、v1.0 です。 これらの API はエンドポイントで https://graph.microsoft.com/v1.0 アクセスできます。 Microsoft Graph API v1.0 バージョンには、一般公開され、運用環境で使用できる機能が含まれています。 v1.0 API のドキュメントについては、「 Microsoft Graph v1.0 エンドポイント リファレンス」を参照してください。

プレビューの状態

Microsoft Graph の API または機能には、その動作がベータ エンドポイントで 一意 であることを示す "(プレビュー)" というラベルが付けられます。

v1.0 バージョンのほとんどの API と機能の動作は、ベータ版バージョンと同等です。 一部の API は、次のいずれかの理由で "プレビュー" としてマークされています。

  • API はベータ版でのみ使用できます
  • API の動作は、ベータ版では v1.0 とは異なります

ベータ エンドポイント内の他の API と同様に、プレビューとしてマークされている API に重大な変更を予告なく導入できます。 運用アプリのベータ エンドポイントから API にアクセスしないでください。

メモ： 機能または製品自体が一般公開されている場合でも、API はプレビュー段階になる可能性があります。

非推奨およびサポートされないバージョン

現在、Microsoft Graph のバージョンは非推奨またはサポートされていません。

利用規約

Microsoft Graph API を使用すると、Microsoft API 使用条件に同意したことになります。

お客様からのフィードバックを重視しています。 Microsoft Q&A でご連絡ください。 [microsoft-graph-*] を使用して質問にタグを付けます。