Freigeben über


Datei nach contentStream abrufen

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Laden Sie die Inhalte des primären Streams (Datei) eines driveItem herunter. Nur driveItem-Objekte mit der Dateieigenschaft können heruntergeladen werden.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
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
App Files.Read.All Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

HTTP-Anforderung

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

Optionale Abfrageparameter

Diese Methode unterstützt keine Abfragemethoden.

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Bereich bytes={range-start}-{range-end}/{size}. Optional. Verwenden Sie , um einen Teilbereich von Bytes aus der Datei herunterzuladen. Angegeben in RFC 2616.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 200 OK HTTP-Antwortcode zurück.

Beispiele

Beispiel 1: Herunterladen von Dateiinhalten

Das folgende Beispiel zeigt, wie Sie eine Datei herunterladen.

Anforderung

GET https://graph.microsoft.com/beta/drives/b!fMInbiL5dkK51VbATG0ddrCg6AJpEj9Lm4uGj5HgEi4guyuYp4W5SbH4dPfXTbCF/items/014Y52UITTNSVUQI43PZBJMKLAY6LJBUVE/contentStream

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK
Content-Type: text/plain

<File Content>

Beispiel 2: Herunterladen eines Teilbereichs von Bytes

Um einen Teilbereich von Bytes aus der Datei herunterzuladen, kann Ihre App den Range -Header verwenden, wie in RFC 2616 angegeben.

Anforderung

GET https://graph.microsoft.com/beta/drives/b!fMInbiL5dkK51VbATG0ddrCg6AJpEj9Lm4uGj5HgEi4guyuYp4W5SbH4dPfXTbCF/items/014Y52UITTNSVUQI43PZBJMKLAY6LJBUVE/contentStream
Range: bytes=0-1023

Antwort

Der Aufruf gibt eine 206 Partial Content HTTP-Antwort mit dem angeforderten Bytebereich aus der Datei zurück. Wenn der Bereich nicht generiert werden kann, wird der Range Header ignoriert und eine 200 OK HTTP-Antwort mit dem vollständigen Inhalt der Datei zurückgegeben.

HTTP/1.1 206 Partial Content
Content-Type: text/plain

<First 1024 bytes of the file>