Hochladen eines Elements nach OneDrive von einer URL (Vorschau)

  • Artikel

Ihre App kann ein Element durch Angabe einer URL nach OneDrive hochladen. OneDrive lädt die Datei direkt von einem Remoteserver herunter, sodass Ihre App die Bytes der Datei nicht hochladen muss. Dies ist besonders hilfreich für mobile Clients oder Browser-Add-Ins, bei denen der Dateiinhalt nicht verfügbar oder die Übertragung kostspielig ist.

Informationen zum Hochladen großer Dateien finden Sie unter Große Dateien mit einer Uploadsitzung hochladen.

Hinweis: Das Hochladen von Elementen von einer URL ist nur für OneDrive Personal möglich.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um diese API aufzurufen. 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) N/V
Delegiert (persönliches Microsoft-Konto) Files.ReadWrite, Files.ReadWrite.All
Anwendung N/V

HTTP-Anforderung

POST /me/drive/items/{parent-item}/children

Anforderungsheader

Name Typ Beschreibung
Prefer string Legen Sie den Header auf respond-async fest, um die asynchrone Elementübertragung zu aktivieren. Andernfalls wird die Anforderung abgebrochen.

Anforderungstext

Der Inhalt des Anforderungstexts sollte die JSON-Darstellung des Elements sein, das von der Remote-URL erstellt werden soll. Beachten Sie, dass beim Herunterladen der Datei durch den Service von der Remote-URL dieser nicht als Benutzer authentifiziert wird, daher muss die URL öffentlich zugänglich sein.

Antwort

Diese Methode gibt detaillierte Informationen zum Überwachen des Status des Downloads, bis die Anforderung akzeptiert wird.

HTTP/1.1 202 Accepted
Location: https://api.onedrive.com/monitor/4A3407B5-88FC-4504-8B21-0AABD3412717

Beispiel

POST /drive/items/{parent-item}/children
Content-Type: application/json
Prefer: respond-async

{
  "@microsoft.graph.sourceUrl": "http://wscont2.apps.microsoft.com/winstore/1x/e33e38d9-d138-42a1-b252-27da1924ca87/Screenshot.225037.100000.jpg",
  "name": "halo-screenshot.jpg",
  "file": { }
}

Antwort

Die Rückgabe durch den Dienst erfolgt unmittelbar nach Annahme der Anforderung; es werden detaillierte Informationen zum Überwachen des Status der Kopie bereitgestellt.

HTTP/1.1 202 Accepted
Location: https://api.onedrive.com/monitor/4A3407B5-88FC-4504-8B21-0AABD3412717

Der Wert des Location-Headers stellt eine URL bereit, die verwendet werden kann, um den aktuellen Status des Vorgangs abzurufen und Sie darüber zu informieren, wenn der Upload abgeschlossen ist.

Hinweise

Das Hochladen eines Elements nach OneDrive for Business, SharePoint Online und SharePoint Server 2016 unter Verwendung einer URL wird nicht unterstützt.