Website-Ressource nach Pfad abrufen

  • Artikel

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