アプリの移行計画チェックリストApp migration planning checklist

重要

Azure AD Graph API は廃止されました。Azure AD Graph API is now deprecated. テクニカル サポートおよびセキュリティ更新プログラムは引き続き提供されますが、機能の更新プログラムは提供されなくなります。We will continue to provide technical support and security updates but will no longer provide feature updates. 2022 年 6 月 30 日より、Azure AD Graph のサポートは終了し、テクニカル サポートやセキュリティ更新プログラムは提供されなくなりました。Starting June 30th, 2022, we will end support for Azure AD Graph and will no longer provide technical support or security updates. この時間以降に Azure AD Graph を使用するアプリは、Azure AD Graph エンドポイントから応答を受信しなくなりました。Apps using Azure AD Graph after this time will no longer receive responses from the Azure AD Graph endpoint.

移行を計画するには、次のチェックリストを使用します。Use the following checklist to plan your migration.

手順 1: API の違いを確認するStep 1: Review the differences between the APIs

多くの点で、Microsoft Graph は以前の Azure ADグラフに似ています。In many respects, Microsoft Graph is similar to the earlier Azure AD Graph. 多くの場合、コード内のエンドポイント サービス名とバージョンを変更するだけで、すべてが引き続き機能する必要があります。In many cases, simply change the endpoint service name and version in your code, and everything should continue to work.

それにもかかわらず、違いがあります。Nonetheless, there are differences. 特定のリソース、プロパティ、メソッド、およびコア機能が変更されました。Certain resources, properties, methods, and core capabilities have changed.

具体的には、次の領域の違いを探します。Specifically, look for differences in the following areas:

手順 2: API の使用を調べるStep 2: Examine API use

アプリで使用される API、 必要なアクセス許可を調べ、既知の相違点の一覧と比較します。Examine the APIs used by your app, the permissions they require, and compare to the list of known differences.

アプリに必要な API が Microsoft Graph v1.0 で一般に使用できると、これらの API が同じ方法で動作するを確認します。Verify that the APIs your app needs are generally available in Microsoft Graph v1.0 and that these APIs work the same way.

場合によっては、以前の方法に代わる新しい機能と機能が設計されています。In some cases, new capabilities and features are designed to replace earlier approaches.

Graph Explorer を使用して、 新しい呼び出しを試し、新しいアプローチを開発します。Use the Graph Explorer to experiment with new calls and to develop new approaches. 最適な結果を得る場合は、テスト テナントのテスト ユーザーの資格情報を使用してサインインし、API が重要なデータ セットに対して何を行うのかを確認します。For best results, sign in using the credentials of a test user in a test tenant so that you see what the API does over important data sets.

手順 3: アプリの詳細を確認するStep 3: Review app details

手順 4: アプリの展開、テスト、および拡張Step 4: Deploy, test, and extend your app

すべてのユーザー向けアプリを更新する前に、徹底的にテストを行い、ロールアウトを顧客の対象ユーザーに対して段階的に行います。Before updating your app for everyone, ensure you test thoroughly and stage your rollout to your customer audience.

これで、Microsoft Graph への切り替えが行われたので、すぐに使用できるデータセットや機能のロックを解除する方が簡単になりました。Now you've made the switch to Microsoft Graph, it's never been easier for you to unlock many more datasets and features that are now at your fingertips. Microsoft Graph の主要なサービスと機能の一部を見て、可能な機能を 確認できますYou can get a taste of what's possible by looking at some of the Major services and features in Microsoft Graph.

現在認証ライブラリ (ADAL) をAD している 場合は、Microsoft 認証ライブラリ (MSAL) への切り替 えを 検討してください。If you're currently using the AD authentication library (ADAL), consider switching to the Microsoft authentication library (MSAL).

次の手順Next Steps

  • 手順 1: API の違いを確認する要求呼び出しの構文について説明します。Learn about request call syntax to start step 1: reviewing API differences.