按路径获取网站资源

命名空间：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"
}