Teilen über


driveItem: copy

Namespace: microsoft.graph

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

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.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

Optionale Abfrageparameter

Diese Methode unterstützt den @microsoft.graph.conflictBehavior Abfrageparameter, um das Verhalten anzupassen, wenn ein Konflikt auftritt.

Wert Beschreibung
fail Das Standardverhalten besteht darin, den Fehler zu melden.
replace Überschreiben Sie ein vorhandenes Element am Zielstandort.
rename Benennen Sie das Element um.

Hinweis:ConflictBehavior wird für OneDrive Consumer nicht unterstützt.

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

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.

Antwort

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

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.

Anforderung

POST https://graph.microsoft.com/v1.0/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

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 ermitteln, wann die Kopie abgeschlossen ist.

Bemerkungen

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. beispielsweise, weil der Zieldateiname bereits verwendet wird.