DriveItem kopierenCopy a DriveItem

Namespace: microsoft.graphNamespace: microsoft.graph

Erstellt asynchron eine Kopie eines driveItem (einschließlich aller untergeordneten Elemente) unter einem neuen übergeordneten Element oder mit einem neuen Namen.Asynchronously creates a copy of an driveItem (including any children), under a new parent item or with a new name.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Files.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.AllFiles.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Files.ReadWrite, Files.ReadWrite.AllFiles.ReadWrite, Files.ReadWrite.All
AnwendungApplication Files.ReadWrite.All, Sites.ReadWrite.AllFiles.ReadWrite.All, Sites.ReadWrite.All

HTTP-AnforderungHTTP request

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

AnforderungstextRequest body

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.In the request body, provide a JSON object with the following parameters.

NameName WertValue BeschreibungDescription
parentReferenceparentReference ItemReferenceItemReference Optional. Verweis auf das übergeordnete Element, in dem die Kopie erstellt wird.Optional. Reference to the parent item the copy will be created in.
namename stringstring Optional. Der neue Name der Kopie. Wenn dieser nicht angegeben wird, wird der gleiche Namen wie für das Original verwendet.Optional. The new name for the copy. If this isn't provided, the same name will be used as the original.

Hinweis: Die ParentReference sollte die Parameter driveId und id für den Zielordner enthalten.Note: The parentReference should include the driveId and id parameters for the target folder.

BeispielExample

In diesem Beispiel wird eine von {item-id} mit einem driveId- und id-Wert identifizierte Datei in einen Ordner kopiert.This example copies a file identified by {item-id} into a folder identified with a driveId and id value. Die neue Kopie der Datei erhält den Namen contoso plan (copy).txt.The new copy of the file will be named 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"
}

AntwortResponse

Die Methode gibt zusammen mit der Annahme der Anforderung Details zur Überwachung des Fortschritts des Kopiervorgangs zurück.Returns details about how to monitor the progress of the copy, upon accepting the request.

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.The value of the Location header provides a URL for a service that will return the current state of the copy operation. You can use this info to determine when the copy has finished.

HinweiseRemarks

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.In many cases the copy action is performed asynchronously. The response from the API will only indicate that the copy operation was accepted or rejected, say due to the destination filename already being in use.