Implantações de nuvem nacional do Microsoft Graph

Este artigo fornece informações sobre as diferentes implantações de nuvem nacional do Microsoft Graph e os recursos disponíveis para desenvolvedores em cada uma.

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 nacional são instâncias físicas e lógicas isoladas da rede dos serviços de nuvem corporativa da Microsoft que estão confinadas dentro das fronteiras geográficas de países/regiões específicos e operadas por 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 diferenças importantes ao desenvolver aplicativos para ambientes de nuvem nacionais; por exemplo, registrar aplicativos, adquirir tokens e chamar a API do Graph Microsoft pode ser diferente.

Observação

O Microsoft Graph Data Connect não oferece suporte a nenhuma das implantações de nuvem nacional.

Registro de aplicativo e pontos de extremidade raiz de serviço de token

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

Nuvem nacional Ponto de extremidade do portal do Azure Ponto de extremidade do 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, consulte noções básicas de autenticação. Para cenários de autenticação, consulte Noções básicas de autenticação da plataforma de identidade da Microsoft.

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

A tabela a seguir mostra os pontos de extremidade raiz de serviço do Microsoft Graph e do 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 o Governo dos EUA L4 (GCC High) https://graph.microsoft.us Sem suporte.
Microsoft Graph para o Governo dos EUA 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 de software que funcione no contexto 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 GCC do Microsoft 365, 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 DoD do Microsoft 365, 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 da nuvem nacional. 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 os dados do consumidor associados às 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 de API para serviços do Microsoft Graph em nuvens nacionais, consulte a referência beta da API e a referência da 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 saber quais serviços estão disponíveis, consulte Disponibilidade do produto por região.

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

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