按路径获取网站资源

命名空间:microsoft.graph

检索 网站 资源的属性和关系。 site 资源表示 SharePoint 中的团队网站。

除了可以按 ID 检索网站外,还可以按相对服务器 URL 路径检索网站。

  • 网站集主机名 (contoso.sharepoint.com)
  • 相对服务器主机名的网站路径。

还有一个保留的网站标识符,即 root。它经常用于引用给定目标的根网站,如下所示:

  • /sites/root:租户根网站。
  • /groups/{group-id}/sites/root:该组的团队网站。

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考

权限类型 最低特权权限 更高特权权限
委派(工作或学校帐户) Sites.Read.All Sites.ReadWrite.All
委派(个人 Microsoft 帐户) 不支持。 不支持。
应用程序 Sites.Read.All Sites.ReadWrite.All

HTTP 请求

GET /sites/{hostname}:/{relative-path}

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权

示例

请求

若要通过相对路径访问根 SharePoint 网站,请运行以下命令:

GET https://graph.microsoft.com/v1.0/sites/{hostname}:/{relative-path}

响应

此方法返回唯一标识符引用的网站的 site 资源。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
  "displayName": "OneDrive Team Site",
  "isPersonalSite": false,
  "name": "1drvteam",
  "createdDateTime": "2017-05-09T20:56:00Z",
  "lastModifiedDateTime": "2017-05-09T20:56:01Z",
  "webUrl": "https://contoso.sharepoint.com/teams/1drvteam"
}