Site-Ressource abrufenGet a site resource

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.

Eine site-Ressource wird durch einen eindeutigen Bezeichner adressiert; dies ist eine aus den folgenden Werten zusammengesetzte ID:A site is addressed by a unique identifier which is a composite ID of the following values:

  • Hostname der Websitesammlung (contoso.SharePoint.com)Site collection hostname (contoso.sharepoint.com)
  • Eindeutige ID der Websitesammlung (GUID)Site collection unique ID (GUID)
  • Eindeutige ID der Website (GUID)Site unique ID (GUID)

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

Abrufen der Stammwebsite eines MandantenGet the tenant's root site

So greifen Sie innerhalb eines Mandanten auf die SharePoint-Stammwebsite zu:To access the root SharePoint site within a tenant:

GET /sites/root
GET /sites/contoso.sharepoint.com

Über eine serverrelative URL auf eine Website zugreifenAccess a site by server-relative URL

Wenn Sie über die serverrelative URL für eine site-Ressource verfügen, können Sie eine Anforderung wie folgt erstellen:If you have the server-relative URL for a site resource, you can construct a request as follows:

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

Auf die Teamwebsite einer Gruppe zugreifenAccess a group team site

So greifen Sie auf die Teamwebsite für eine Gruppe zu:To access the team site for a group:

GET /groups/{group-id}/sites/root

BeispielExample

AnforderungRequest

GET /sites/{site-id}

AntwortResponse

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