如何使用Beta Graph API查询多地域SharePoint中特定地域的站点？

架构老林

2026-8-5

解决Microsoft Graph Beta SDK查询多地域SharePoint站点的问题

默认情况下，Microsoft Graph Beta API只会返回租户默认地域的SharePoint站点，要获取其他地域的站点，必须在请求中明确指定地域参数或针对目标地域的站点集合发起查询。以下是具体实现方案：

查询特定地域的站点

可以通过$filter条件筛选指定地域的站点，地域代码需与你的SharePoint多地域配置一致（例如US、EU、AP）：

var graphClient = new GraphServiceClient(authProvider);

// 查询欧洲地域的所有站点
var targetRegionSites = await graphClient.Sites
    .Request()
    .Filter("siteCollection/geo eq 'EU'")
    .GetAsync();

如果需要获取特定地域根站点下的子站点，可直接定位到该地域的根站点再查询子站点：

// 获取欧洲地域的根站点
var euRootSite = await graphClient.Sites.GetByPath("/", "eu.sharepoint.com").GetAsync();
// 获取该根站点下的所有子站点
var euSubSites = await graphClient.Sites[euRootSite.Id].Sites.Request().GetAsync();

查询所有地域的站点

需要遍历租户所有已配置的地域代码，逐个查询对应地域的站点后合并结果：

var graphClient = new GraphServiceClient(authProvider);
var allSites = new List<Site>();
// 替换为你的租户实际配置的地域代码列表
var tenantRegions = new[] { "US", "EU", "AP" };

foreach (var region in tenantRegions)
{
    var regionSites = await graphClient.Sites
        .Request()
        .Filter($"siteCollection/geo eq '{region}'")
        .GetAsync();
    
    allSites.AddRange(regionSites.CurrentPage);
    
    // 处理分页结果，确保获取所有站点
    while (regionSites.NextPageRequest != null)
    {
        regionSites = await regionSites.NextPageRequest.GetAsync();
        allSites.AddRange(regionSites.CurrentPage);
    }
}