Compartir a través de

restoreSessionBase: activate

  • Artículo

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.

Active un objeto restoreSessionBase de borrador para restaurar una unidad de protección.

Los puntos siguientes se aplican a la restauración de una unidad de protección:

  • Los sitios de SharePoint y las cuentas de OneDrive que se restauran no están bloqueados en un estado de solo preparación.
  • En el caso de los sitios de SharePoint y OneDrive restaurados en nuevas direcciones URL, los usuarios no tienen los mismos permisos que tenían en el sitio original. Solo el administrador global o el administrador de SharePoint tienen permiso para el sitio restaurado. Sin embargo, en el caso de las restauraciones en contexto o en la misma dirección URL, se conservan los permisos del sitio original en el momento de la restauración.
  • No se admite la restauración del sitio de SharePoint y el contenido de usuario de OneDrive que se quitó de la papelera de reciclaje.
  • Los buzones de correo, las cuentas de OneDrive y los sitios de SharePoint que se encuentran en retenciones legales o locales no se pueden restaurar a menos que se quite la suspensión legal. Para restaurar un sitio de SharePoint en suspensión legal, debe restaurar el sitio a una nueva dirección URL.
  • No se hace una copia de seguridad de los elementos de borrador de buzón de correo y no se pueden restaurar.
  • No se realiza una restauración si el estado actual del buzón es el mismo que el momento en el que intenta restaurarlo.
  • Los sitios de SharePoint y las cuentas de OneDrive que se restauran en una nueva dirección URL tienen un bloqueo de solo lectura en esa nueva dirección URL hasta que se complete la restauración. El administrador global todavía puede descargar documentos o quitar manualmente el bloqueo de solo lectura.
  • Cuando se realiza una restauración en una nueva ubicación, rellenar los detalles de la propiedad de la nueva ubicación puede tardar más de 15 minutos.
  • El administrador global, el administrador de SharePoint o el administrador de Exchange pueden iniciar una restauración de hasta 1000 sitios de SharePoint, 1000 usuarios de OneDrive y 1000 buzones en cola en paralelo a la vez.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores 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) BackupRestore-Restore.ReadWrite.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación BackupRestore-Restore.ReadWrite.All No disponible.

Solicitud HTTP

POST /solutions/backupRestore/restoreSessions/{restoreSessionBaseId}/activate

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.

Cuerpo de la solicitud

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

Respuesta

Si se ejecuta correctamente, esta acción devuelve un 200 OK código de respuesta y un objeto restoreSessionBase en el cuerpo de la respuesta.

Para obtener una lista de posibles respuestas de error, consulte Backup Storage API error responses (Respuestas de error de la API de Backup Storage).

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/beta/solutions/backupRestore/restoreSessions/61633878-8321-4950-bfaf-ed285bdd1461/activate

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 200 OK
Content-Type: application/json

{
  "@odata.context": " /solutions/backupRestore/$metadata#restoreSessions/$entity",
  "@odata.id": "/solutions/backupRestore/sharepointRestoreSessions(61633878-8321-4950-bfaf-ed285bdd1461)",
  "@odata.type": "#microsoft.graph.sharepointRestoreSession",
  "id": "61633878-8321-4950-bfaf-ed285bdd1461",
  "status": "activating",
  "restoreJobType": "standard",
  "restoreSessionArtifactCount": {
    "total": 2,
    "completed": 0,
    "inProgress": 2,
    "failed": 0
  },
  "createdBy": {
    "application": {
      "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
      "displayName": "Microsoft Enhanced Restore"
    },
    "user": {
      "id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
      "displayName": "User1"
    }
  },
  "createdDateTime": "2015-06-19T12:01:03.45Z",
  "lastModifiedBy": {
    "application": {
      "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
      "displayName": "Microsoft Enhanced Restore"
    },
    "user": {
      "id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
      "displayName": "User2"
    }
  },
  "lastModifiedDateTime": "2015-06-19T12:01:03.45Z"
}