driveItem: move

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Mover un elemento de unidad a un nuevo elemento primario.

Para mover un elemento de unidad a un nuevo elemento principal, la aplicación solicita una actualización del elemento parentReference del elemento de unidad que se va a mover. El movimiento es un tipo especial de operación de actualización . La aplicación puede mover un elemento a un nuevo contenedor y actualizar otras propiedades del elemento en una sola solicitud.

Cuando se mueve un elemento de unidad al mismo sitio o contenedor, todos los vínculos para compartir existentes siguen funcionando. Si el elemento de unidad se mueve a otro sitio o contenedor, los vínculos para compartir existentes ya no funcionan.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ✅

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
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

Nota:

SharePoint Embedded requiere permiso FileStorageContainer.Selected para acceder al contenido del contenedor. Este permiso es diferente de los mencionados anteriormente. Además de los permisos de Microsoft Graph, la aplicación debe tener los permisos de tipo de contenedor necesarios para llamar a esta API. Para obtener más información, consulte Autenticación y autorización de SharePoint Embedded.

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

Nombre Tipo Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
if-match String Si se incluye este encabezado de solicitud y el eTag (o cTag) proporcionado no coincide con el eTag actual en la carpeta, se devuelve una 412 Precondition Failed respuesta. Opcional.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione el nuevo valor de la propiedad parentReference. Las propiedades existentes que no están incluidas en el cuerpo de la solicitud mantienen sus valores anteriores o se vuelven a calcular en función de los cambios realizados en otros valores de propiedad. Para obtener un rendimiento óptimo, incluya solo los valores que cambian y omita los que no cambian.

Nota:

Cuando se mueven elementos a la raíz de una unidad, la aplicación debe usar el identificador real de la carpeta raíz como referencia primaria en lugar de la "id: root" sintaxis.

Respuesta

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

Para obtener información acerca de cómo se devuelven los errores, consulte Respuestas de error.

Ejemplos

Solicitud

En el ejemplo siguiente se mueve un elemento especificado por {item-id} a una carpeta de la unidad del usuario con el identificador new-parent-folder-id.

PATCH https://graph.microsoft.com/beta/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"
  }
}