Website-Ressource nach Pfad abrufenGet a site resource by path

Dient zum Abrufen der Eigenschaften und Beziehungen einer site-Ressource. Eine site-Ressource stellt eine Teamwebsite in SharePoint dar.Retrieve properties and relationships for a site resource. A site resource represents a team site in SharePoint.

Zusätzlich zum Abrufen einer Website nach ID können Sie eine Website basierend auf dem serverrelativen URL-Pfad abrufen.In addition to retrieving a site by ID you can retrieve a site based on server-relative URL path.

  • Hostname der Websitesammlung (contoso.sharepoint.com)Site collection hostname (contoso.sharepoint.com)
  • Websitepfad relativ zum Hostnamen des ServersSite path, relative to server hostname.

Es gibt auch einen reservierten Websitebezeichner, root, der immer auf die Stammwebsite für ein angegebenes Ziel verweist, wie folgt:There is also a reserved site identifier, root, which always references the root site for a given target, as follows:

  • /sites/root: Der Stammwebsite des Mandanten./sites/root: The tenant root site.
  • /groups/{group-id}/sites/root: Die Teamwebsite der Gruppe./groups/{group-id}/sites/root: The group's team site.

BerechtigungenPermissions

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Sites.Read.All, Sites.ReadWrite.AllSites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Sites.Read.All, Sites.ReadWrite.AllSites.Read.All, Sites.ReadWrite.All

HTTP-AnforderungHTTP Request

So greifen Sie mit einem relativen Pfad auf die SharePoint-Stammwebsite zu:To access the root SharePoint site with a relative path:

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

AntwortResponse

Diese Methode gibt eine site-Ressource für die Website zurück, auf die vom eindeutigen Bezeichner verwiesen wird.This method returns a site resource for the site referenced by the unique identifier.

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