Site-Ressource abrufen

Artikel
04/08/2023

Dient zum Abrufen der Eigenschaften und Beziehungen einer site-Ressource. Eine site-Ressource stellt eine Teamwebsite in SharePoint dar.

Eine site-Ressource wird durch einen eindeutigen Bezeichner adressiert; dies ist eine aus den folgenden Werten zusammengesetzte ID:

Hostname der Websitesammlung (contoso.SharePoint.com)
Eindeutige ID der Websitesammlung (GUID)
Eindeutige ID der Website (GUID)

Es gibt auch einen reservierten Websitebezeichner, root, der immer auf die Stammwebsite für ein angegebenes Ziel verweist, wie folgt:

/sites/root: Der Stammwebsite des Mandanten.
/groups/{group-id}/sites/root: Die Teamwebsite der Gruppe.

Darüber hinaus kann auf die Stammwebsite für eine bestimmte geografische Instanz (für Multi-Geo-Mandanten) wie folgt mit dem dataLocationCode der geography zugegriffen werden:

/sites/NAM: Die Stammwebsite der nordamerikanischen Instanz des Mandanten
/sites/EUR: Die Stammwebsite der europäischen Instanz des Mandanten

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

Abrufen der Stammwebsite eines Mandanten

So greifen Sie innerhalb eines Mandanten auf die SharePoint-Stammwebsite zu:

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

Über eine serverrelative URL auf eine Website zugreifen

Wenn Sie über die serverrelative URL für eine site-Ressource verfügen, können Sie eine Anforderung wie folgt erstellen:

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

Auf die Teamwebsite einer Gruppe zugreifen

So greifen Sie auf die Teamwebsite für eine Gruppe zu:

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

Beispiel

Anforderung

GET /sites/{site-id}

Antwort

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

Freigeben über