在 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管理员角色的详细信息，请参阅：
- 关于 Microsoft 365 管理中心中的管理员角色
- Microsoft Entra内置角色
- Microsoft 365 中的角色，包括Microsoft Entra ID角色、特定于服务的角色和跨服务角色
在没有用户的情况下访问服务通信 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 |
国家云中的可用性
该服务通信 API 在所有 Microsoft 国家/地区云部署中均可用。 可以获取 Microsoft 国家云中任何租户的服务运行状况和通信数据。 有关详细信息，请参阅 国家云部署。
| 国家云 | 部分) (API URL |
|---|---|
| Microsoft Graph 全局服务 | https://graph.microsoft.com/beta/admin/serviceAnnouncement/| |
| Microsoft Graph for US Government L4 (GccHigh) | https://graph.microsoft.us/beta/admin/serviceAnnouncement/ |
| Microsoft Graph for US Government L5 (DoD) | https://dod-graph.microsoft.us/beta/admin/serviceAnnouncement/ |
| 由世纪互联运营的 Microsoft Graph 中国 | https://microsoftgraph.chinacloudapi.cn/beta/admin/serviceAnnouncement/ |
服务通信限制
为了保证服务性能，服务通信 API 对每个应用程序每个租户的请求有限制。 有关限制的详细信息，请参阅 服务通信服务的限制。
后续步骤
服务通信 API 可以开辟与用户互动的新方式：
- 在 Microsoft Graph 中访问服务运行状况和通信的概述
- 尝试在 Graph 浏览器中调用 API。