Kaganapan
Mar 17, 9 PM - Mar 21, 10 AM
Sumali sa serye ng meetup upang bumuo ng mga scalable AI solusyon batay sa mga kaso ng paggamit ng tunay na mundo sa mga kapwa developer at eksperto.
Magparehistro naMicrosoft Graph national cloud deployments
This article provides information about the different Microsoft Graph national cloud deployments and the capabilities that are available to developers within each.
In addition to a global network of datacenters, Microsoft cloud services are available in two separate national clouds. These national cloud versions are physical and logical network-isolated instances of Microsoft enterprise cloud services that are confined within the geographic borders of specific countries/regions and operated by local personnel.
Current national clouds include:
- Microsoft Cloud for US Government
- Microsoft Azure and Microsoft 365 operated by 21Vianet in China
Each national cloud environment is unique and different than the Microsoft global environment. It's important to be aware of some of these key differences when you develop applications for national cloud environments; for example, registering applications, acquiring tokens, and calling the Microsoft Graph API can be different.
Note
Microsoft Graph Data Connect does not support any of the national cloud deployments.
Before calling the Microsoft Graph APIs, you should first register your application and acquire a token. The following table lists the base URLs for the endpoints to register your application and acquire tokens for each national cloud.
| National cloud | Azure portal endpoint | Microsoft Entra ID endpoint |
|---|---|---|
| Azure global service | https://portal.azure.com |
https://login.microsoftonline.com |
| Azure US Government | https://portal.azure.us |
https://login.microsoftonline.us |
| Azure China operated by 21Vianet | https://portal.azure.cn |
https://login.chinacloudapi.cn |
To learn more about access tokens and Microsoft Graph, see authentication basics. For authentication scenarios, see Microsoft identity platform authentication basics.
The following table shows the service root endpoints for Microsoft Graph and Graph Explorer for each national cloud.
| National Cloud | Microsoft Graph | Graph Explorer |
|---|---|---|
| Microsoft Graph global service | https://graph.microsoft.com |
https://developer.microsoft.com/graph/graph-explorer |
| Microsoft Graph for US Government L4 | https://graph.microsoft.us |
Not supported. |
| Microsoft Graph for US Government L5 (DOD) | https://dod-graph.microsoft.us |
Not supported. |
| Microsoft Graph China operated by 21Vianet | https://microsoftgraph.chinacloudapi.cn |
Not supported. |
Mahalaga
For a software application working in US Government context, use the following root endpoints for the Azure portal and Microsoft Graph respectively.
- If you're working in a Microsoft 365 GCC environment, continue using the worldwide endpoints:
https://portal.azure.comandhttps://graph.microsoft.com. - If you're working in a Microsoft 365 GCC High environment, use
https://portal.azure.usandhttps://graph.microsoft.us. - If you're working in a Microsoft 365 DoD environment, use
https://portal.azure.usandhttps://dod-graph.microsoft.us.
Note
Apps can only access organizational data through the national cloud endpoints. This means that apps can only access data in tenants that are registered in the specific national cloud. Apps that are trying to access consumer data associated with Microsoft personal accounts through Microsoft Graph should use the global service https://graph.microsoft.com. Access tokens acquired for a national cloud deployment are not interchangeable with those acquired for the global service or any other national cloud.
For details about API support for Microsoft Graph services in national clouds, see the API beta reference and API v1.0 reference.
Mahalaga
Certain services and features that are in specific regions of the global service might not be available in all national clouds. To find out what services are available, see Product Availability by Region.
To learn more about national clouds, see the following articles:
- Microsoft National Clouds
- Microsoft 365 for US Government
- Microsoft 365 operated by 21Vianet
- Azure Government
- Azure China 21Vianet
Explore samples for authenticating and working with Azure and Microsoft 365 in National cloud deployments:
Mga karagdagang mapagkukunan
Pagsasanay
Module
What is Microsoft Graph? - Training
Microsoft Graph provides access to data stored across Microsoft 365 services. Custom applications can use the Microsoft Graph API to connect to data and use it in custom applications to enhance organizational productivity.
Sertipikasyon
Microsoft 365 Certified: Fundamentals - Certifications
Demonstrate understanding of Microsoft 365, to deliver industry-leading productivity apps along with intelligent cloud services, and world-class security.