Mover un objeto DriveItem a una carpeta nueva

  • Artículo

Para mover un objeto DriveItem a un nuevo elemento primario, la aplicación solicita actualizar la parentReference del objeto DriveItem que se moverá.

Este es un caso especial del método Update. La aplicación puede mover un elemento a un nuevo contenedor y actualizar otras propiedades del elemento en una sola solicitud.

No se pueden mover elementos entre Drives con esta solicitud.

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/{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 el nuevo valor de la propiedad parentReference. 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 no debe incluir valores existentes que no hayan cambiado.

Nota: Al mover elementos a la raíz de una unidad, la aplicación no puede usar la sintaxis "id:" "root". La aplicación debe proporcionar el identificador real de la carpeta raíz para la referencia primaria.

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

En este ejemplo, se mueve un elemento especificado mediante {item-id} a una carpeta en la unidad del usuario con el identificador new-parent-folder-id.

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

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

Respuesta

En el ejemplo siguiente se muestra la respuesta de esta solicitud de movimiento.

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"
  }
}

Respuestas de error

Vea Respuestas de error para obtener más información sobre la manera en que se devuelven los errores.