Restaurar elemento eliminado

Espacio de nombres: microsoft.graph

Restaura un elemento eliminado recientemente de la carpeta Elementos eliminados.

Actualmente, la funcionalidad restaurar elementos eliminados solo se admite para los recursos de aplicación, servicePrincipal, grupo y usuario . Si un elemento se ha eliminado accidentalmente, puede restaurarlo por completo. Esto no es aplicable a los grupos de seguridad, que se eliminan de forma permanente.

Un elemento eliminado recientemente seguirá estando disponible durante 30 días. Después de 30 días, el elemento se elimina permanentemente.

Permisos

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

Para aplicaciones y entidades de servicio:

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) Application.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida.
Application Application.ReadWrite.OwnedBy, Application.ReadWrite.All

Para los usuarios:

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

Para los grupos:

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

Solicitud HTTP

POST /directory/deletedItems/{id}/restore

Encabezados de solicitud

Nombre Descripción
Authorization Token de portador> <requerido
Tipo de contenido application/json

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

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

Ejemplo

Solicitud

POST https://graph.microsoft.com/v1.0/directory/deletedItems/{object-id}/restore

Respuesta

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

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

{
  "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#directoryObjects/$entity",
  "@odata.type":"#microsoft.graph.group",
  "id":"46cc6179-19d0-473e-97ad-6ff84347bbbb",
  "displayName":"SampleGroup",
  "groupTypes":["Unified"],
  "mail":"example@contoso.com",
  "mailEnabled":true,
  "mailNickname":"Example",
  "securityEnabled":false,
  "visibility":"Public"
}