Website-Ressource nach Pfad abrufen

Artikel
02/07/2024

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

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp	Berechtigungen mit den geringsten Berechtigungen	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	Sites.Read.All	Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Anwendung	Sites.Read.All	Sites.ReadWrite.All

HTTP-Anforderung

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

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.

Beispiel

Anforderung

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

GET https://graph.microsoft.com/v1.0/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",
  "isPersonalSite": false,
  "name": "1drvteam",
  "createdDateTime": "2017-05-09T20:56:00Z",
  "lastModifiedDateTime": "2017-05-09T20:56:01Z",
  "webUrl": "https://contoso.sharepoint.com/teams/1drvteam"
}

Freigeben über