通过

枚举网站

列出组织中与提供的筛选条件和查询选项匹配的可用 站点 。

目前仅支持以下查询选项：

Filter 语句 Select 语句 说明
siteCollection/root ne null siteCollection,webUrl 列出组织中的所有根级网站集。 对于发现每个地理位置的主站点非常有用。

此外，还可以对“/sites”集合使用 搜索 查询来查找与给定关键字匹配的网站。

权限

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

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

HTTP 请求

GET /sites?filter=siteCollection/root ne null

示例

请求

GET /sites?select=siteCollection,webUrl&filter=siteCollection/root%20ne%20null

响应

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

{
  "value": [
    {
      "id": "contoso.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740",
      "name": "Contoso USA",
      "root": { },
      "siteCollection": {
        "hostname": "contoso.sharepoint.com",
        "dataLocationCode": "NAM",
        "root": { }
      },
      "webUrl": "https://contoso.sharepoint.com"
    },
    {
      "id": "contoso-jpn.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,0271110f-634f-4300-a841-3a8a2e851851",
      "name": "Contoso Japan",
      "root": { },
      "siteCollection": {
        "hostname": "contoso-jp.sharepoint.com",
        "dataLocationCode": "JPN",
        "root": { }
      },
      "webUrl": "https://contoso-jp.sharepoint.com"
    }
  ]
}
  • Last updated on