アプリの移行計画チェックリスト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 Graph に似ています。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 v2.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 エクスプローラーを使用して、新しい通話をテストし、新しいアプローチを開発します。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. いくつかの を見て、考えられることを知ることができます。You can get a taste of what's possible by looking at some examples.

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

次の手順Next Steps