Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Namespace: microsoft.graph
Create a new oneDriveForBusinessRestoreSession object. To create a granular restore session, granular drive restore artifacts must be present in the payload. A request can't include both granularDriveRestoreArtifact and driveRestoreArtifact in the same create or update request.
If no payload is provided when you create the restore session, the request creates an empty standard restore session by default.
API availability
This API is available in the following national cloud deployments.
| Global service | US Government L4 | US Government L5 (DOD) | China operated by 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Permissions
Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.
| Permission type | Least privileged permission | Higher privileged permissions |
|---|---|---|
| Delegated (work or school account) | BackupRestore-Restore.ReadWrite.All | Not available. |
| Delegated (personal Microsoft account) | Not supported. | Not supported. |
| Application | BackupRestore-Restore.ReadWrite.All | Not available. |
HTTP request
POST /solutions/backupRestore/oneDriveForBusinessRestoreSessions
Request headers
| Name | Description |
|---|---|
| Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
| Content-Type | application/json. Required. |
Request body
In the request body, supply a JSON representation of the oneDriveForBusinessRestoreSession object.
You can specify the following properties when you create a oneDriveForBusinessRestoreSession.
| Property | Type | Description |
|---|---|---|
| @microsoft.graph.conflictBehavior | String | An optional instance annotation that specifies conflict handling for every artifact in a granular restore session. The possible values are: fail (default), replace, and rename. With fail, a conflicting artifact fails to restore; replace overwrites the existing item; rename preserves the existing item and gives the restored item a nonconflicting name. If you supply this annotation for a non-granular session, the request returns 400 Bad Request. |
| driveRestoreArtifacts | driveRestoreArtifact collection | A collection of driveRestoreArtifact objects. Required. |
| granularDriveRestoreArtifacts | granularDriveRestoreArtifact collection | A collection of granularDriveRestoreArtifact objects. Required. |
| policyId | String | The identifier of the protection policy that scopes the restore session. The service validates that the referenced protection units belong to this policy. Optional. Inherited from restoreSessionBase. |
To restore granular artifacts to their original location, set destinationType to inPlace on each artifact. A single session can't mix destination types.
Response
If successful, this method returns a 201 Created response code and a oneDriveForBusinessRestoreSession object in the response body.
For a list of possible error responses, see Backup Storage API error responses.
Examples
Example 1: Create a standard restore session
The following example shows how to create a standard restore session.
Request
The following example shows a request.
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/oneDriveForBusinessRestoreSessions
Content-Type: application/json
{
"policyId": "99999999-aaaa-bbbb-cccc-dddddddddddd",
"driveRestoreArtifacts": [
{
"restorePoint": { "id": "1f1fccc3-a642-4f61-bf49-f37b9a888279" },
"destinationType": "new"
},
{
"restorePoint": { "id": "1f1fccc3-a642-4f61-bf49-f37b9a888280" },
"destinationType": "new"
}
]
}
Response
The following example shows the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.context": "/solutions/backupRestore/$metadata#oneDriveForBusinessRestoreSession/$entity",
"id": "959ba739-70b5-43c4-8c90-b2c22014f18b",
"status": "draft",
"restoreJobType": "standard",
"policyId": "99999999-aaaa-bbbb-cccc-dddddddddddd",
"restoreSessionArtifactCount": {
"total": 2,
"completed": 0,
"inProgress": 0,
"failed": 0
},
"createdBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"createdDateTime": "2023-03-30T12: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": "2023-03-30T12:01:03.45Z"
}
Example 2: Create an in-place granular restore session
The following example shows how to restore OneDrive for Business artifacts to their original location and replace existing same-name items.
Request
The following example shows a request.
POST https://graph.microsoft.com/v1.0/solutions/backupRestore/oneDriveForBusinessRestoreSessions
Content-Type: application/json
{
"@microsoft.graph.conflictBehavior": "replace",
"granularDriveRestoreArtifacts": [
{
"browseSessionId": "eJxVjEEKwjAQRfc80xeIleluFd2HRkZCgAIEu9CO3aUv78W4H_q_NgQY2gSJHT8IoOhrl5AzosZGBk6",
"id": "a535851e-9fc6-4eb1-90ab-2955fd9117b5,2a8b7eaf-092a-4561-a25a-998ad2e5142e,38eec3f1-b879-44a6-8ae6-05bd46ed4b3d,ce66019f-cdf9-4575-aa81-de3aabe844a2",
"destinationType": "inPlace"
},
{
"browseSessionId": "eJxVjEEKwjAQRfc80xeIleluFd2HRkZCgAIEu9CO3aUv78W4H_q_NgQY2gSJHT8IoOhrl5AzosZGBk6",
"id": "b535851e-9fc6-4eb1-90ab-2955fd9117b5,2a8b7eaf-092a-4561-a25a-998ad2e5142e,38eec3f1-b879-44a6-8ae6-05bd46ed4b3d,ce66019f-cdf9-4575-aa81-de3aabe844a2",
"destinationType": "inPlace"
}
]
}
For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.
Response
The following example shows the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.context": "/solutions/backupRestore/$metadata#oneDriveForBusinessRestoreSession/$entity",
"id": "959ba739-70b5-43c4-8c90-b2c22014f18b",
"status": "draft",
"restoreJobType": "granular",
"restoreSessionArtifactCount": {
"total": 2,
"completed": 0,
"inProgress": 0,
"failed": 0
},
"createdBy": {
"application": {
"id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264",
"displayName": "Microsoft Enhanced Restore"
},
"user": {
"id": "845457dc-4bb2-4815-bef3-8628ebd1952e",
"displayName": "User1"
}
},
"createdDateTime": "2023-03-30T12: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": "2023-03-30T12:01:03.45Z"
}