Freigeben über

Website-Ressource nach Pfad abrufen

  • Artikel

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

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

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

GET https://graph.microsoft.com/beta/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

{
  "id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
  "owner": {
    "user": {
      "displayName": "Daron Spektor",
      "id": "5280E7FE-DC7A-4486-9490-E790D81DFEB3"
    }
  },
  "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"
}