调用Microsoft Graph API /connections GET接口返回UnknownError问题求助

问题排查与解决步骤 #

• 接口路径修正
  你调用的接口路径已变更，v1.0版本的外部连接器列表接口路径为/external/connections，而非根路径下的/connections。对应C#代码需要修改最后一行调用逻辑：

  // 错误写法
  // var connections = await graphClient.Connections.Request().GetAsync();
  // 正确写法
  var connections = await graphClient.External.Connections.Request().GetAsync();
  

  Graph Explorer中调用时也需要将请求路径改为https://graph.microsoft.com/v1.0/external/connections。

• 权限配置校验
  该接口需要配置对应权限才能正常调用：

  1. Azure应用注册侧：需要添加应用权限ExternalConnection.ReadWrite.OwnedBy或ExternalConnection.Read.All，配置完成后必须点击「授予管理员同意」才会生效
  2. Graph Explorer侧：需要在界面的「权限」面板中勾选对应权限并完成授权后再发起请求

• 许可证校验
  外部连接器功能依赖Microsoft 365 E3/E5或对应搜索附加许可证，若租户未开通相关许可证，也会触发未知错误，可以联系租户管理员确认许可证配置情况。

内容的提问来源于stack exchange，提问作者Ara