Website-Ressource nach Pfad abrufen

Namespace: microsoft.graph

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

Zusätzlich zum Abrufen einer Website nach ID können Sie eine Website basierend auf dem serverrelativen URL-Pfad abrufen.

• Hostname der Websitesammlung (contoso.sharepoint.com)
• Websitepfad relativ zum Hostnamen des Servers

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.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema 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

So greifen Sie mit einem relativen Pfad auf die SharePoint-Stammwebsite zu:

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

Antwort

Diese Methode gibt eine site-Ressource für die Website zurück, auf die vom eindeutigen Bezeichner verwiesen wird.

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