Freigeben über

Website-Ressource nach Pfad abrufen

  • Artikel

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

HTTP-Anforderung

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

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

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