DriveItem-Eigenschaften aktualisierenUpdate DriveItem properties

Namespace: microsoft.graphNamespace: microsoft.graph

Dient zum Aktualisieren der Metadaten für ein DriveItem anhand ID oder Pfad.Update the metadata for a DriveItem by ID or path.

Mithilfe dieser API können Sie außerdem Elemente unter ein anderes übergeordnetes Element verschieben, indem Sie die Eigenschaft parentReference des zu verschiebenden Elements aktualisieren.You can also use update to move an item to another parent by updating the item's parentReference property.

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

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}

Optionale AnforderungsheaderOptional request headers

NameName TypType BeschreibungDescription
if-matchif-match StringString Wenn dieser Anforderungsheader enthalten ist und das angegebene etag (oder cTag) nicht mit dem aktuellen etag des Ordners übereinstimmt, wird die Antwort 412 Precondition Failed zurückgegeben.If this request header is included and the eTag (or cTag) provided does not match the current eTag on the folder, a 412 Precondition Failed response is returned.

AnforderungstextRequest body

Geben Sie im Anforderungstext die Werte für die Eigenschaften an, die aktualisiert werden sollen.In the request body, supply the values for properties that should be updated.

Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. Um eine optimale Leistung zu erzielen, sollte Ihre App keine Eigenschaften umfassen, die sich nicht geändert haben.For best performance your app should not include properties that haven't changed.

AntwortResponse

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und die aktualisierte DriveItem-Ressource im Antworttext zurückgegeben.If successful, this method returns a 200 OK response code and updated DriveItem resource in the response body.

BeispielExample

In diesem Beispiel wird die DriveItem-Ressource in "new-file-name.docx" umbenannt.This example renames the DriveItem resource to "new-file-name.docx".

PATCH /me/drive/items/{item-id}
Content-type: application/json

{
  "name": "new-file-name.docx"
}

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird eine driveItem-Ressource im Antworttext zurückgegeben.If successful, this method returns an driveItem resource in the response body.

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

{
  "id": "01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK",
  "name": "new-file-name.docx",
  "file": { }
}

FehlerantwortenError responses

Weitere Informationen dazu, wie Fehler zurückgegeben werden, finden Sie unter Fehlerantworten.See Error Responses for details about how errors are returned.