Implantações nacionais de nuvem do Microsoft Graph

  • Artigo

Este artigo fornece informações sobre as diferentes implantações de nuvem nacionais do Microsoft Graph e os recursos que estão disponíveis para desenvolvedores em cada um deles.

Além de uma rede global de datacenters, os serviços de nuvem da Microsoft estão disponíveis em duas nuvens nacionais separadas. Essas versões de nuvem nacionais são instâncias físicas e lógicas isoladas de rede dos serviços de nuvem corporativos da Microsoft que estão confinadas nas fronteiras geográficas de países específicos e operadas pelo pessoal local.

As nuvens nacionais atuais incluem:

  • Microsoft Cloud para o Governo dos EUA
  • Microsoft Azure e Microsoft 365 operados pela 21Vianet na China

Cada ambiente de nuvem nacional é único e diferente do ambiente global da Microsoft. É importante estar ciente de algumas dessas principais diferenças ao desenvolver aplicativos para ambientes de nuvem nacionais; por exemplo, registrar aplicativos, adquirir tokens e chamar o microsoft API do Graph pode ser diferente.

Observação

O Microsoft Graph Data Connect não dá suporte a nenhuma das implantações de nuvem nacionais.

Pontos de extremidade raiz do registro do aplicativo e do serviço de token

Antes de chamar as APIs do Microsoft Graph, primeiro você deve registrar seu aplicativo e adquirir um token. A tabela a seguir lista as URLs base dos pontos de extremidade para registrar seu aplicativo e adquirir tokens para cada nuvem nacional.

Nuvem nacional ponto de extremidade portal do Azure ponto de extremidade Microsoft Entra ID
Serviço global do Azure https://portal.azure.com https://login.microsoftonline.com
Azure Governo dos EUA https://portal.azure.us https://login.microsoftonline.us
Azure China operado pela 21Vianet https://portal.azure.cn https://login.chinacloudapi.cn

Para saber mais sobre tokens de acesso e Microsoft Graph, confira noções básicas de autenticação. Para cenários de autenticação, consulte plataforma de identidade da Microsoft noções básicas de autenticação.

Microsoft Graph e Graph Explorer pontos de extremidade raiz do serviço

A tabela a seguir mostra os pontos de extremidade raiz do serviço para o Microsoft Graph e o Graph Explorer para cada nuvem nacional.

National Cloud Microsoft Graph Explorador do Graph
Serviço global do Microsoft Graph https://graph.microsoft.com https://developer.microsoft.com/graph/graph-explorer
Microsoft Graph para L4 do Governo dos EUA https://graph.microsoft.us Sem suporte.
Microsoft Graph for US Government L5 (DOD) https://dod-graph.microsoft.us Sem suporte.
Microsoft Graph China operado pela 21Vianet https://microsoftgraph.chinacloudapi.cn Sem suporte.

Importante

Para um aplicativo em nuvens do governo dos EUA, use os seguintes pontos de extremidade raiz para o portal do Azure e o Microsoft Graph, respectivamente.

  • Se você estiver trabalhando em um ambiente do Microsoft 365 GCC, continue usando os pontos de extremidade em todo o mundo: https://portal.azure.com e https://graph.microsoft.com.
  • Se você estiver trabalhando em um ambiente do Microsoft 365 GCC High, use https://portal.azure.us e https://graph.microsoft.us.
  • Se você estiver trabalhando em um ambiente do Microsoft 365 DoD, use https://portal.azure.us e https://dod-graph.microsoft.us.

Observação

Os aplicativos só podem acessar dados organizacionais por meio dos pontos de extremidade de nuvem nacionais. Isso significa que os aplicativos só podem acessar dados em locatários registrados na nuvem nacional específica. Os aplicativos que estão tentando acessar dados de consumidor associados a contas pessoais da Microsoft por meio do Microsoft Graph devem usar o serviço https://graph.microsoft.comglobal . Os tokens de acesso adquiridos para uma implantação de nuvem nacional não são intercambiáveis com aqueles adquiridos para o serviço global ou qualquer outra nuvem nacional.

Suporte à API de serviço em nuvens nacionais

Para obter detalhes sobre o suporte à API para serviços do Microsoft Graph em nuvens nacionais, consulte a referência beta da API e a referência de API v1.0.

Importante

Determinados serviços e recursos que estão em regiões específicas do serviço global podem não estar disponíveis em todas as nuvens nacionais. Para descobrir quais serviços estão disponíveis, consulte produtos disponíveis por região.

Conteúdo relacionado

Para saber mais sobre nuvens nacionais, confira os seguintes artigos:

Explore exemplos para autenticar e trabalhar com o Azure e o Microsoft 365 em implantações de nuvem nacionais: