Saving OneDrive Folders
You can save backed-up OneDrive folders.
OneDrive folders are always saved in a ZIP archive. When you save backed-up OneDrive folders, the request command archives the folders and places the ZIP archive a temporary folder on the Veeam Backup for Microsoft 365 server. After that, the archive is transferred as application/octet-stream media to the client. To download, read or perform other actions with the octet-stream, use features of programming languages.
|
You can use Swagger UI to download data from the stream by clicking the Download action link in the response body. For more information, see Evaluation in Swagger UI. |
Request
POST https://<hostname>:4443/v6/RestoreSessions/{restoreSessionId}/Organization/OneDrives/{oneDriveId}/Folders/save |
Request Headers
The request header must contain an authorization token of the current session.
Request Parameters
The following parameters must be specified in the URL of the request:
Parameter | Type | Description |
---|---|---|
restoreSessionId | string | Specifies the identification number of the restore session. For more information on how to get this parameter, see Getting Restore Sessions. |
oneDriveId | string | Specifies the identification number of OneDrive. For more information on how to get this parameter, see Getting OneDrives. |
Request Body
To save backed-up OneDrive folders, the request body must contain the following property:
Property | Type | Description |
---|---|---|
folders | folder[] | Specifies the IDs of OneDrive folders that you want to save. For more information on how to get such IDs, see Getting OneDrive Folders. |
For example:
Request Body: { "folders": [ {"id": "bbc9960c-767b-428a-ac6c-c75bb8f7c548"}, {"id": "5e63a8c7-72c8-4070-a7de-6b8e288b0177"} ] } |
Response
The server returns the following response to the client.
Response Codes
A successfully completed operation returns a response code 200 OK.
Response Headers
The response to this request contains the following headers. The response may also include additional standard HTTPS headers.
Header | Description |
---|---|
Content-length | The length of the response body. |
Content-type | The media type and syntax of the response body message for the requests with the export and save actions: application/octet-stream. The media type and syntax of the response body message for the requests with the restore and send actions: null. |
Response Body
In the response body, the server returns binary data stream.
Example
The example shows how to save OneDrive folders.
Request: POST https://abc.tech.local:4443/v6/RestoreSessions/445e8385-89fd-4789-a1ca-6f89468a163b/Organization/OneDrives/1d3740ca-bd0e-4656-88ed-2e35ce10e1deef4221af-9351-41ec-9128-534cf34db1a5/Folders/save
Request Header: Authorization: Bearer <Access-Token>
Request Body: { "folders": [ {"id": "bbc9960c-767b-428a-ac6c-c75bb8f7c548"}, {"id": "5e63a8c7-72c8-4070-a7de-6b8e288b0177"} ] }
Response: 200 OK |