在 Microsoft Graph 中使用服务通信 API

  • 项目

服务通信 API 提供与租户订阅的 Microsoft 云服务相关的服务运行状况和消息中心帖子。 可以获取 Microsoft 服务的当前和历史运行状况数据， (例如，Exchange Online服务已关闭) 。 可以检查服务运行状况，以确定在致电支持人员或花时间进行故障排除之前，是否跟踪了问题并正在解决问题。 消息中心帖子允许你跟踪即将进行的更改，包括新功能、更新和其他重要公告 (，例如，Exchange Online正在获取新功能) 。

Authorization

Microsoft Graph 允许应用程序获得对租户订阅的 Microsoft 云服务的运行状况和更改通信的授权访问权限。 借助适当的委派权限或应用程序 权限，应用可以代表已登录用户访问通信数据，也可以代表租户中的任何登录用户访问通信数据。 这些权限的委托类型和应用程序类型都仅由管理员授予。

有关访问令牌、应用注册以及委派和应用程序权限的详细信息，请参阅 身份验证和授权基础知识。

代表已登录用户访问服务通信 API

需要委派权限才能代表已登录用户访问服务通信 API。 面向客户的画布应用程序（例如Microsoft 365 管理中心 (，仅供管理员角色) 访问）可以调用服务通信 API，以代表已登录用户的租户获取服务运行状况和服务公告数据。 用户可以了解其订阅的服务器是否正常或有问题。 他们还可以了解影响其租户的任何当前服务问题。

委托访问的基于角色的访问控制

服务通信 API 还应用基于角色的访问控制 (RBAC) ，以确定代表的已登录用户是否需要Microsoft Entra角色。 代表 的已登录用户必须至少具有一个管理员角色。

有关Microsoft Entra管理员角色的详细信息，请参阅：

在没有用户的情况下访问服务通信 API

在没有登录用户的情况下访问服务通信 API 需要应用程序权限。 作为后端服务（如监视或警报服务）运行的应用程序可以使用自己的标识调用服务通信 API，而不是代表用户。 这些后端服务可以生成自定义监视/警报管道，并调用服务通信 API 来获取服务运行状况和服务公告数据。

常见用例和所需权限

用例 API 请求 所需权限 支持的权限类型
列出租户的运行状况概述 列出运行状况概述 ServiceHealth.Read.All 委托和应用程序
获取租户的特定服务运行状况信息 获取 serviceHealth ServiceHealth.Read.All 委托和应用程序
列出租户的所有服务问题 列出问题 ServiceHealth.Read.All 委托和应用程序
获取租户的特定服务问题 获取问题 ServiceHealth.Read.All 委托和应用程序
获取租户的事件后评审报告 获取事件报告 ServiceHealth.Read.All 委托和应用程序
列出租户的所有服务消息 列出邮件 ServiceMessage.Read.All 委托和应用程序
获取租户的特定服务消息 获取邮件 ServiceMessage.Read.All 委托和应用程序
更新已登录用户的服务消息状态 有关状态操作的列表，请参阅 serviceUpdateMessage。 ServiceMessageViewpoint.Write Delegated

Microsoft Graph 国家/地区云可用性

服务通信 API 在 Microsoft Graph 国家/地区云上可用。 可以获取国家/地区云租户的服务运行状况和通信数据。

国家云 部分) (API URL
Microsoft Graph 全局服务 https://graph.microsoft.com/v1.0/admin/serviceAnnouncement/|
Microsoft Graph for US Government L4 (GccHigh) https://graph.microsoft.us/v1.0/admin/serviceAnnouncement/
Microsoft Graph for US Government L5 (DoD) https://dod-graph.microsoft.us/v1.0/admin/serviceAnnouncement/
由世纪互联运营的 Microsoft Graph 中国 https://microsoftgraph.chinacloudapi.cn/v1.0/admin/serviceAnnouncement/

有关国家云可用性的详细信息，请参阅 Microsoft Graph 国家云。

服务通信限制

为了保证服务性能，服务通信 API 对每个应用程序每个租户的请求有限制。 有关限制的详细信息，请参阅 服务通信服务的限制。

后续步骤

服务通信 API 可以开辟与用户互动的新方式。 有关详细信息，请参阅：