应用迁移规划清单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 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 浏览器 体验新的呼叫并开发新的方法。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