通过

获取网站资源

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

网站可按唯一标识符处理，此唯一标识符是下列值的复合 ID：

  • 网站集主机名称 (contoso.sharepoint.com)
  • 网站集的唯一 ID (GUID)
  • 网站的唯一 ID (GUID)

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

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

此外，可以使用地理位置的 dataLocationCode 访问特定地理实例的根站点 (多地理位置租户) ，如下所示：

  • /sites/NAM：租户的北美实例的根站点
  • /sites/EUR：租户的欧洲实例的根站点

权限

调用此 API 需要以下权限之一。 若要了解详细信息，包括如何选择权限的信息，请参阅权限。

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

获取租户的根网站

若要访问租户内的根 SharePoint 网站：

GET /sites/root
GET /sites/contoso.sharepoint.com
GET /sites/JPN

通过相对于服务器的 URL 访问网站

如果你的服务器具有网站资源的相对于服务器的 URL，你可以构建请求，如下所示：

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

访问组团队网站

若要访问组的团队网站：

GET /groups/{group-id}/sites/root

示例

请求

GET /sites/{site-id}

响应

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"
}
  • Last updated on