Freigeben über


Verschieben eines driveItem in einen neuen Ordner

Namespace: microsoft.graph

Um ein driveItem-Element in ein neues übergeordnetes Element zu verschieben, fordert Ihre App an, die parentReference des zu verschiebenden DriveItem zu aktualisieren.

Dies ist ein Sonderfall der Update-Methode . Die App kann das Verschieben eines Elements zu einem neuen Container und das Aktualisieren anderer Eigenschaften des Elements in einer einzigen Anforderung verbinden.

Elemente können mit dieser Anforderung nicht zwischen verschiedenen Ressourcen des Typs Drive verschoben werden.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. 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

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

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.
if-match Zeichenfolge. Wenn dieser Anforderungsheader enthalten ist und das angegebene eTag (oder cTag) nicht mit dem aktuellen eTag im Ordner übereinstimmt, wird eine 412 Precondition Failed Antwort zurückgegeben.

Anforderungstext

Geben Sie im Anforderungstext den neuen Wert für die parentReference-Eigenschaft an. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Um eine optimale Leistung zu erzielen, sollten Sie keine vorhandenen Werte einschließen, die sich nicht ändern.

Anmerkung: Beim Verschieben von Elementen in den Stamm eines Laufwerks kann Ihre App die "id:" "root" Syntax nicht verwenden. Ihre App muss die tatsächliche ID des Stammordners für den übergeordneten Verweis bereitstellen. Beispiel: /drives/{drive-id}/root.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und die aktualisierte driveItem-Ressource im Antworttext zurückgegeben.

Beispiel

In diesem Beispiel wird ein durch {item-id} angegebenes Element mit der ID new-parent-folder-id auf das Laufwerk des Benutzers verschoben.

PATCH https://graph.microsoft.com/v1.0/me/drive/items/{item-id}
Content-type: application/json

{
  "parentReference": {
    "id": "{new-parent-folder-id}"
  },
  "name": "new-item-name.txt"
}

Antwort

Das folgende Beispiel zeigt die Antwort für diese Verschiebungsanforderung.

HTTP/1.1 200 OK
Content-type: application/json

{
  "id": "0123456789abc",
  "name": "new-item-name.txt",
  "parentReference":
  {
    "driveId": "11231001",
    "path": "/drive/root:/Documents",
    "id": "1231203102!1011"
  }
}

Fehlerantworten

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