DriveItem kopieren

Erstellt asynchron eine Kopie eines driveItem (einschließlich aller untergeordneten Elemente) unter einem neuen übergeordneten Element oder mit einem neuen Namen.

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

POST /drives/{driveId}/items/{itemId}/copy
POST /groups/{groupId}/drive/items/{itemId}/copy
POST /me/drive/items/{item-id}/copy
POST /sites/{siteId}/drive/items/{itemId}/copy
POST /users/{userId}/drive/items/{itemId}/copy

Anforderungstext

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.

Name	Wert	Beschreibung
parentReference	ItemReference	Optional. Verweis auf das übergeordnete Element, in dem die Kopie erstellt wird.
name	string	Optional. Der neue Name der Kopie. Wenn dieser nicht angegeben wird, wird der gleiche Namen wie für das Original verwendet.

Hinweis: Die ParentReference sollte die Parameter driveId und id für den Zielordner enthalten.

Beispiel

In diesem Beispiel wird eine von {item-id} mit einem driveId- und id-Wert identifizierte Datei in einen Ordner kopiert. Die neue Kopie der Datei erhält den Namen contoso plan (copy).txt.

POST /me/drive/items/{item-id}/copy
Content-Type: application/json

{
  "parentReference": {
    "driveId": "6F7D00BF-FC4D-4E62-9769-6AEA81F3A21B",
    "id": "DCD0D3AD-8989-4F23-A5A2-2C086050513F"
  },
  "name": "contoso plan (copy).txt"
}

Antwort

Die Methode gibt zusammen mit der Annahme der Anforderung Details zur Überwachung des Fortschritts des Kopiervorgangs zurück.

HTTP/1.1 202 Accepted
Location: https://contoso.sharepoint.com/_api/v2.0/monitor/4A3407B5-88FC-4504-8B21-0AABD3412717

Der Wert des Location-Headers enthält eine Dienst-URL, die den aktuellen Status des Kopiervorgangs zurückgibt. Anhand dieser Informationen können Sie herausfinden, wann der Kopiervorgang abgeschlossen ist.

Hinweise

In vielen Fällen wird die Aktion zum Kopieren asynchron durchgeführt. Die Antwort der API gibt nur an, dass der Kopiervorgang akzeptiert oder abgelehnt wurde, wenn der Zieldateiname zum Beispiel bereits verwendet wird.