You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

通过Graph API访问SharePoint是否需按特定格式传递Site_ID?

Microsoft Graph API访问SharePoint时Site_ID的格式说明

是否必须使用「主机名,网站集GUID,网站GUID」格式?

不一定,这个格式是全局唯一标识,适用于所有场景,但Graph API支持多种Site ID的指定方式,具体取决于你要访问的资源和已知信息。

直接传递网站GUID报错的原因

单独的网站GUID不具备全局唯一性——不同网站集甚至不同租户里,都可能存在相同的网站GUID。Graph API无法仅通过这个GUID定位到具体站点,因此会返回「站点未找到」的错误。只有在同一个网站集内部,网站GUID才是唯一的,但跨集或跨租户场景下,必须补充足够的标识信息让API准确定位。

其他正确的调用方式

以下是几种常用的有效方式:

  • 使用网站URL路径:通过主机名和站点的服务器相对路径定位,格式为 GET /sites/{hostname}:/{server-relative-path}
    示例:GET /sites/contoso.sharepoint.com:/sites/marketing
  • 使用网站集GUID访问根站点:如果目标是网站集的根站点,直接传递网站集GUID即可,格式为 GET /sites/{site-collection-id}
    示例:GET /sites/abc123-def456-ghi789-jkl012
  • 使用根站点简化标识:针对租户的默认根站点,可以直接用 /sites/root 或者 /sites/{tenant-domain} 访问
    示例:GET /sites/root
  • 网站集GUID+相对路径:如果知道网站集ID和子站点的相对路径,格式为 GET /sites/{site-collection-id}:/{relative-path}
    示例:GET /sites/abc123-def456-ghi789-jkl012:/sites/sales

内容的提问来源于stack exchange,提问作者Kailash Sahoo

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.20 09:37:05