Compartir a través de

Actualizar propiedades de DriveItem

  • Artículo

Actualiza los metadatos de un DriveItem por identificador o ruta de acceso.

También puede usar una actualización para mover un elemento a otro elemento primario actualizando la propiedad parentReference del elemento.

Permisos

Se requiere uno de los permisos siguientes para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) Files.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All
Delegado (cuenta personal de Microsoft) Files.ReadWrite, Files.ReadWrite.All
Aplicación Files.ReadWrite.All, Sites.ReadWrite.All

Solicitud HTTP

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}

Encabezados de solicitud opcionales

Nombre Tipo Descripción
if-match String Si se incluye el encabezado de la solicitud y la eTag (o cTag) proporcionada no coincide la eTag actual en la carpeta, se devuelve una respuesta 412 Precondition Failed.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione los valores de las propiedades que deben actualizarse.

Las propiedades existentes que no se incluyan en el cuerpo de la solicitud mantendrán los valores anteriores o se recalcularán según los cambios efectuados en otros valores de propiedad. Para obtener el mejor rendimiento la aplicación no debe incluir propiedades que no hayan cambiado.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y el recurso DriveItem actualizado en el cuerpo de la respuesta.

Ejemplo

Este ejemplo cambia el nombre del recurso DriveItem por "new-file-name.docx".

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

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

Respuesta

Si se ejecuta correctamente, este método devuelve un recurso driveItem en el cuerpo de la respuesta.

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

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

Respuestas de error

Vea Respuestas de error para obtener los detalles sobre la manera en que se devuelven los errores.