Freigeben über

DriveItem-Ressource abrufen

  • Artikel

Mit dieser API können Sie die Metadaten einer Ressource des Typs DriveItem in einer Ressource des Typs Drive abrufen. Hierzu verwenden Sie den Dateisystempfad oder die ID der Ressource des Typs „DriveItem“.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. 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) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Anwendung Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

HTTP-Anforderung

GET /drives/{drive-id}/items/{item-id}
GET /drives/{drive-id}/root:/{item-path}
GET /groups/{group-id}/drive/items/{item-id}
GET /groups/{group-id}/drive/root:/{item-path}
GET /me/drive/items/{item-id}
GET /me/drive/root:/{item-path}
GET /sites/{siteId}/drive/items/{itemId}
GET /sites/{siteId}/drive/root:/{item-path}
GET /users/{userId}/drive/items/{itemId}
GET /users/{userId}/drive/root:/{item-path}

Optionale Abfrageparameter

Diese Methode unterstützt die $expandOData-Abfrageparameter und $select zum Anpassen der Antwort.

Sie können den $expandParameter der Abfragezeichenfolge verwenden, um die untergeordneten Elemente eines Elements im gleichen Aufruf wie beim Abrufen der Metadaten eines Elements verwenden, wenn das Element eine untergeordnete Beziehung aufweist.

Optionale Anforderungsheader

Name Wert Beschreibung
if-none-match String Wenn dieser Anforderungsheader enthalten ist und das angegebene eTag (oder cTag) mit dem aktuellen Tag in der Datei übereinstimmt, wird die Antwort HTTP 304 Not Modified zurückgegeben.

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und die aktualisierte DriveItem-Ressource im Antworttext zurückgegeben.

Beispiel

Anforderung

Nachfolgend finden Sie ein Beispiel der Anforderung für den Stammordner des OneDrive-Elements des Benutzers.

GET /me/drive/root

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

HTTP/1.1 200 OK
Content-type: application/json

{
  "createdBy": {
      "user": {
          "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
          "displayName": "Ryan Gregg"
      }
  },
  "createdDateTime": "2016-03-21T20:01:37Z",
  "cTag": "\"c:{86EB4C8E-D20D-46B9-AD41-23B8868DDA8A},0\"",
  "eTag": "\"{86EB4C8E-D20D-46B9-AD41-23B8868DDA8A},1\"",
  "folder": { "childCount": 120 },
  "id": "01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK",
  "lastModifiedBy": {
      "user": {
          "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
          "displayName": "Ryan Gregg"
      }
  },
  "lastModifiedDateTime": "2016-03-21T20:01:37Z",
  "name": "OneDrive",
  "root": { },
  "size": 157286400,
  "webUrl": "https://contoso-my.sharepoint.com/personal/rgregg_contoso_com/Documents"
}

HEAD-Anforderungen

In den meisten Fällen verhält sich eine HEAD-Anforderung genauso wie eine GET-Anforderung.

Es gibt einige Unterschiede:

  1. HEAD-Anfragen geben nur den Header für die entsprechende GET-Anforderung zurück. Dies ist das Standardverfahren für eine HEAD-Antwort.
  2. HEAD-Anfragen stellen nicht automatisch einen speziellen Ordner bereit. Stattdessen wird ein 404-Fehler zurückgegeben, wenn kein spezieller Ordner vorhanden ist.

In diesem Beispiel können Sie sehen, dass beim Anfordern der Stammebene Ihres OneDrive einfach die Antwort 200 OK zurückgegeben wird.

HTTP-Anforderung

HEAD /drive/root
Accept: application/json

Antwort

HTTP/1.1 200 OK

Bemerkungen

Weitere Informationen dazu, wie Fehler zurückgegeben werden, finden Sie unter Fehlerantworten.