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 .