Site-Ressource abrufenGet a site resource

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

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

SDK-BeispielcodeSDK sample code


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var site = await graphClient.Sites["{site-id}"]
    .Request()
    .GetAsync();

In der SDK-Dokumentation finden Sie Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider -Instanz.Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.