反馈 编辑

在 Microsoft Graph 中处理服务通信 API

  • 项目

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

Authorization

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

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

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

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

无需用户即可访问服务通信 API

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

常见用例和所需权限

用例 API 请求 所需权限 支持的权限类型
列出租户的运行状况概述 列出 healthOverviews 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

服务通信 API 还可用于 Microsoft Graph云。 你可以获取你的国家云租户的服务运行状况和通信数据。 有关 Microsoft 云Graph云。

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

服务通信限制

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

最近更新

了解此 API 集的最新功能和更新。

后续步骤

服务通信 API 可以开启与用户互动的新方式：

需要更多灵感？请参阅我们的一些合作伙伴如何使用 Microsoft Graph。