restoreSessionBase : activer
Espace de noms: microsoft.graph
Activez un brouillon d’objet restoreSessionBase .
Les points suivants s’appliquent à la restauration d’une unité de protection :
- Les sites SharePoint et les comptes OneDrive en cours de restauration ne sont pas verrouillés dans un état prêt uniquement.
- Pour les sites SharePoint et OneDrive restaurés vers de nouvelles URL, les utilisateurs ne disposent pas des mêmes autorisations qu’ils avaient sur le site d’origine. Seul l’administrateur général ou l’administrateur SharePoint est autorisé à accéder au site restauré. Toutefois, pour les restaurations sur place ou vers la même URL, les autorisations du site d’origine au moment de la restauration sont conservées.
- La restauration du site SharePoint et du contenu utilisateur OneDrive qui a été supprimé de la Corbeille n’est pas prise en charge.
- Les boîtes aux lettres, les comptes OneDrive et les sites SharePoint qui sont en attente légale ou sur place ne peuvent pas être restaurés, sauf si la conservation légale est supprimée. Pour restaurer un site SharePoint sous conservation légale, vous devez restaurer le site vers une nouvelle URL.
- Les éléments brouillons de boîte aux lettres ne sont pas sauvegardés et ne peuvent pas être restaurés.
- Une restauration n’est pas effectuée si l’état actuel de la boîte aux lettres est identique au point dans le temps auquel vous essayez de la restaurer.
- Les sites SharePoint et les comptes OneDrive restaurés vers une nouvelle URL ont un verrou en lecture seule sur cette nouvelle URL jusqu’à la fin de la restauration. L’administrateur général peut toujours télécharger des documents ou supprimer manuellement le verrou en lecture seule.
- Lorsqu’une restauration vers un nouvel emplacement est effectuée, le remplissage des détails de la propriété du nouvel emplacement peut prendre plus de 15 minutes.
- L’administrateur général, l’administrateur SharePoint ou l’administrateur Exchange peut lancer une restauration de jusqu’à 1 000 sites SharePoint, 1 000 utilisateurs OneDrive et 1 000 boîtes aux lettres mises en file d’attente en parallèle à la fois.
Cette API est disponible dans les déploiements de cloud national suivants.
| Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
| Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
|---|---|---|
| Déléguée (compte professionnel ou scolaire) | BackupRestore-Restore.ReadWrite.All | Non disponible. |
| Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
| Application | BackupRestore-Restore.ReadWrite.All | Non disponible. |
Requête HTTP
POST /solutions/backupRestore/restoreSessions/{restoreSessionBaseId}/activate
En-têtes de demande
| Nom | Description |
|---|---|
| Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Corps de la demande
N’indiquez pas le corps de la demande pour cette méthode.
Réponse
Si elle réussit, cette action renvoie un 200 OK code de réponse et un objet restoreSessionBase dans le corps de la réponse.
Pour obtenir la liste des réponses d’erreur possibles, consultez Réponses d’erreur de l’API de stockage de sauvegarde.
Exemples
Demande
L’exemple suivant illustre une demande.
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/restoreSessions/61633878-8321-4950-bfaf-ed285bdd1461/activate
Réponse
L’exemple suivant illustre la réponse.
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
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",
"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"
}