通过

按路径获取网站资源

  • 项目

检索 网站 资源的属性和关系。 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 请求

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

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

HTTP 响应

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

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",
  "name": "1drvteam",
  "createdDateTime": "2017-05-09T20:56:00Z",
  "lastModifiedDateTime": "2017-05-09T20:56:01Z",
  "webUrl": "https://contoso.sharepoint.com/teams/1drvteam"
}