Websites auflisten

Artikel
04/08/2023

Listen Sie die verfügbaren Websites in einer Organisation auf, die den angegebenen Filterkriterien und Abfrageoptionen entsprechen.

Derzeit werden nur die folgenden Abfrageoptionen unterstützt:

Filter-Anweisung	Select-Anweisung	Beschreibung
`siteCollection/root ne null`	`siteCollection,webUrl`	Listet alle Websitesammlungen auf Stammebene in der Organisation auf. Nützlich zum Ermitteln der Startseite für die einzelnen Geografien.

Darüber hinaus können Sie eine Suchabfrage für die Sammlung "/sites" verwenden, um Websites zu finden, die bestimmten Schlüsselwörtern entsprechen.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um diese API aufzurufen. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Sites.Read.All, Sites.ReadWrite.All

HTTP-Anforderung

GET /sites?filter=siteCollection/root ne null

Beispiel

Anforderung

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

Antwort

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"
    }
  ]
}

Freigeben über