recycleBinItem: restore

Espacio de nombres: microsoft.graph

Restaurar objetos recycleBinItem de la papelera de reciclaje de un fileStorageContainer. Un recycleBinItem se puede restaurar mediante su id o utilizando el driveItemId original como una clave alternativa.

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) FileStorageContainer.Selected No disponible.
Delegado (cuenta personal de Microsoft) FileStorageContainer.Selected No disponible.
Aplicación FileStorageContainer.Selected No disponible.

Nota:

Además de los permisos de Microsoft Graph, la aplicación debe tener los permisos de nivel de contenedor necesarios para llamar a esta API. Para obtener más información, consulte Tipos de contenedor. Para obtener más información sobre los permisos de nivel de tipo de contenedor, consulte Autorización de SharePoint Embedded.

Solicitud HTTP

POST /storage/fileStorage/containers/{containerId}/recycleBin/items/restore

Restaure un único elemento recycleBinItem mediante la driveItemId como una clave alternativa. Si no hay ningún recycleBinItem que coincida con el driveItemId, la API devuelve una respuesta 404 (No encontrado).

POST /storage/fileStorage/containers/{containerId}/recycleBin/items(driveItemId='{driveItemId}')/restore

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

Si la restauración se realiza mediante recycleBinItemId, en el cuerpo de la solicitud, proporcione una representación JSON de los objetos recycleBinItem que se van a restaurar. Si está restaurando mediante driveItemId como una clave alternativa, no es necesario un cuerpo de solicitud.

Respuesta

Si se restaura correctamente mediante recycleBinItemId, este método devuelve un 207 Multi-Status código de respuesta y el conjunto de objetos recycleBinItem restaurados en el cuerpo de la respuesta.

Si se restaura correctamente como driveItemId clave alternativa, este método devuelve un código de respuesta 200 OK con el identificador del singular recycleBinItem que se restauró en el cuerpo de la respuesta.

Ejemplos

Ejemplo 1: Restaurar un recycleBinItem

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST  https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/recycleBin/items/restore
Content-Type: application/json

{
  "ids": ["5d625d33-338c-4a77-a98a-3e287116440c", "73133853-48f2-4956-bc4a-03f8d1675042"]
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 207 Multi-Status
Content-Type: application/json

{
  "value": [
    {
      "id": "5d625d33-338c-4a77-a98a-3e287116440c"
    },
    {
      "id": "73133853-48f2-4956-bc4a-03f8d1675042"
    }
  ]
}

Ejemplo 2: Restaurar un recycleBinItem mediante driveItemId como clave alternativa

En este ejemplo, se driveItemId pasa como parámetro de función en la dirección URL de la solicitud. La respuesta devuelve el id. correspondiente de la recycleBinItem persona que se restauró.

Solicitud

POST https://graph.microsoft.com/beta/storage/fileStorage/containers/b!LRJHKCBZQU2fLtv8TzUomsz-OP7yGQRNlugra1iGHqRe5fORWrrHTbh8J8O8qPmx/recycleBin/items(driveItemId='01GC3BS4QFPBCZRLJHJVEYPITEHTDBYHBH')/restore
Content-Type: application/json

Respuesta

HTTP/1.1 200 Ok
Content-Type: application/json
{
  "id": "bf7ea563-b848-4ec8-9155-b2054564cfe4"
}

Ejemplo 3: Error al restaurar recycleBinItem por driveItemId como clave alternativa

En este ejemplo, no hay ningún elemento recycleBinItem coincidente que deba correlacionarse con el elemento driveItemId especificado. La API devuelve una respuesta 404 (No encontrada).

Solicitud

POST https://graph.microsoft.com/beta/storage/fileStorage/containers/e!JDJHKCBZTU2fLtv8TzUoksz-OP7yGQRNlugra1iGHqRe5fORWrrHTbh8J8O8qPmx/recycleBin/items(driveItemId='01jC3BS4QFPBCZRLGHJVEYPITEHTDBYHBP')/restore
Content-Type: application/json

Respuesta

HTTP/1.1 404 Not Found
Content-Type: application/json

{
  "error": {
    "code": "NotFound",
    "message": "The requested resource could not be found."
  }
}
  • Last updated on