Microsoft Graph 国家/地区云部署

本文提供有关不同的 Microsoft Graph 国家云部署的信息,以及每个部署中可供开发人员使用的功能。

除了数据中心的全球网络外,Microsoft 云服务还可用于两个独立的国家云。 这些国家云版本是 Microsoft 企业云服务的物理和逻辑网络隔离实例,它们限制在特定国家的地理边界内,由当地人员运营。

当前区域云包括:

  • Microsoft Cloud for US Government
  • 中国的 Microsoft Azure 和 由世纪互联运营的 Microsoft 365

每个国家/地区云环境都是唯一的,并且不同于 Microsoft 全球环境。 为国家云环境开发应用程序时,请务必了解其中一些关键差异:例如,注册应用程序、获取令牌和调用 Microsoft 图形 API可能有所不同。

注意

Microsoft Graph Data Connect 不支持任何国家/地区云部署。

应用注册和令牌服务根终结点

在调用 Microsoft Graph API 之前,应首先注册应用程序并获取令牌。 下表列出了用于注册应用程序并获取每个国家/地区云的令牌的终结点的基 URL。

国家云 Azure 门户终结点 Microsoft Entra ID终结点
Azure 全局服务 https://portal.azure.com https://login.microsoftonline.com
Azure US 政府 https://portal.azure.us https://login.microsoftonline.us
由世纪互联运营的 Azure 中国 https://portal.azure.cn https://login.chinacloudapi.cn

若要详细了解访问令牌和 Microsoft Graph,请参阅 身份验证基础知识。 有关身份验证方案,请参阅Microsoft 标识平台身份验证基础知识

Microsoft Graph 和 Graph 资源管理器服务根终结点

下表显示了每个国家/地区云的 Microsoft Graph 和 Graph 资源管理器 的服务根终结点。

区域云 Microsoft Graph Graph 浏览器
Microsoft Graph 全局服务 https://graph.microsoft.com https://developer.microsoft.com/graph/graph-explorer
Microsoft Graph for US Government L4 https://graph.microsoft.us 不支持。
Microsoft Graph for US Government L5 (DOD) https://dod-graph.microsoft.us 不支持。
由世纪互联运营的 Microsoft Graph 中国 https://microsoftgraph.chinacloudapi.cn 不支持。

重要

对于美国政府云中的应用,请分别对 Azure 门户 和 Microsoft Graph 使用以下根终结点。

  • 如果在 Microsoft 365 GCC 环境中工作,请继续使用全球终结点: https://portal.azure.comhttps://graph.microsoft.com
  • 如果你在 Microsoft 365 GCC High 环境中工作,请使用 https://portal.azure.ushttps://graph.microsoft.us
  • 如果你在 Microsoft 365 DoD 环境中工作,请使用 https://portal.azure.ushttps://dod-graph.microsoft.us

注意

应用只能通过国家云终结点访问组织数据。 这意味着应用只能访问在特定国家/地区云中注册的租户中的数据。 尝试通过 Microsoft Graph 访问与 Microsoft 个人帐户关联的消费者数据的应用应使用全局服务 https://graph.microsoft.com。 为国家云部署获取的访问令牌与为全球服务或任何其他国家云获取的访问令牌不可互换。

国家云中的服务 API 支持

有关国家云中 Microsoft Graph 服务的 API 支持的详细信息,请参阅 API beta 参考API v1.0 参考

重要

全球服务特定区域中的某些服务和功能可能并非在所有国家/地区云中都可用。 若要了解可用的服务,请参阅 按区域提供的产品

若要了解有关国家云的详细信息,请参阅以下文章:

浏览用于在国家云部署中对 Azure 和 Microsoft 365 进行身份验证和使用的示例: