Inhalte eines DriveItem hochladen oder ersetzen

  • Artikel

Mit der einfachen Upload-API können Sie den Inhalt einer neuen Datei bereitstellen oder den Inhalt einer vorhandenen Datei in einem einzigen API-Aufruf aktualisieren. Diese Methode unterstützt nur Dateien, die bis zu 4MB groß sind.

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

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) Files.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Files.ReadWrite, Files.ReadWrite.All
Anwendung Files.ReadWrite.All, Sites.ReadWrite.All

HTTP-Anforderung (um ein vorhandenes Element zu ersetzen)

PUT /drives/{drive-id}/items/{item-id}/content
PUT /groups/{group-id}/drive/items/{item-id}/content
PUT /me/drive/items/{item-id}/content
PUT /sites/{site-id}/drive/items/{item-id}/content
PUT /users/{user-id}/drive/items/{item-id}/content

HTTP-Anforderung (um eine neue Datei hochzuladen)

PUT /drives/{drive-id}/items/{parent-id}:/{filename}:/content
PUT /groups/{group-id}/drive/items/{parent-id}:/{filename}:/content
PUT /me/drive/items/{parent-id}:/{filename}:/content
PUT /sites/{site-id}/drives/{drive-id}/{parent-id}:/{filename}:/content
PUT /users/{user-id}/drive/items/{parent-id}:/{filename}:/content

Anforderungstext

Der Inhalt des Anforderungstexts sollte den binären Stream der hochzuladenden Datei sein.

Antwort

Wenn die Methode erfolgreich verläuft, wird ein driveItem-Objekt im Antworttext der neu erstellten oder aktualisierten Datei zurückgegeben.

Beispiel (Hochladen einer neuen Datei)

In diesem Beispiel wird die Zeichenfolge "The contents of the file goes here." in eine Datei auf dem Laufwerk des angemeldeten Benutzers unter FolderA mit dem Namen FileB.txt hochgeladen.

PUT /me/drive/root:/FolderA/FileB.txt:/content
Content-Type: text/plain

The contents of the file goes here.

Antwort

Wenn die Methode erfolgreich verläuft, wird eine driveItem-Ressource im Antworttext der neu erstellten Datei zurückgegeben.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "0123456789abc",
  "name": "FileB.txt",
  "size": 35,
  "file": { }
}

Beispiel (Aktualisieren einer vorhandenen Datei)

In diesem Beispiel wird der Inhalt einer Datei durch eine bekannte ID ersetzt.

PUT /me/drive/items/{item-id}/content
Content-Type: text/plain

The contents of the file goes here.

Antwort

Wenn die Methode erfolgreich verläuft, wird eine driveItem-Ressource im Antworttext der neu erstellten Datei zurückgegeben.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "0123456789abc",
  "name": "FileB.txt",
  "size": 35,
  "file": { }
}

Bemerkungen

Gesperrte Dateitypen

SharePoint Server 2016 blockiert denn Upload einiger Dateierweiterungen auf den Server.

  • .ashx – ASP.NET-Webhandlerdatei
  • .asmx – Quelldatei für ASP.NET-Webdienste
  • .json – JavaScript Object Notation-Datei
  • .soap – Simple Object Access Protocol-Datei
  • .svc – WCF-Dienstdatei (Windows Communication Foundation)
  • .xamlx – Visual Studio Workflow-Dienstdatei

Weitere Informationen zu blockierten Dateierweiterungen finden Sie unter Dateitypen, die einer Liste oder Bibliothek nicht hinzugefügt werden können.

Konfliktlösungs-Verhalten

Standardmäßig wird mit dieser API ein vorhandenes Element mit dem gleichen Namen ersetzt. Um das Konfliktauflösungsverhalten anzupassen, fügen Sie der Anforderung einen Abfrageparameter mit dem Namen @microsoft.graph.conflictBehavior hinzu, der werte fail, replace oder rename enthält.

Fehlerantworten

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