Creates a backup job for the organization with a specified ID.
Request
To create a backup job for the organization added to Veeam Backup for Microsoft Office 365, send the POST HTTPS request to the URL of the /Organizations/{ID}/Jobs resource.
HTTPS Request
POST https://<Backup-Office365>:4443/v2/Organizations/{ID}/Jobs |
Request Headers
The request contains the following headers:
Header | Required | Description |
---|---|---|
Content-Type: application/json | true | Specifies the type of the content for your request. |
Authorization: Bearer <Access-Token> | true | The request header must contain the authorization token for the current logon session. |
Request Body
The request body must contain the following properties:
Property | Type | Description |
---|---|---|
Name | string | Specifies the name of the backup job. For example, "name": "Backup Job ABC". |
Description | string | Specifies the description of the backup job. For example, "description": "Critical Mailboxes". |
BackupType | backupType | Specifies the type of the backup job:
|
SchedulePolicy | Specifies the backup job scheduling options. | |
ProxyId | string | Specifies the ID of the backup proxy where the repository with backups is located. For example, "proxyId": "5a905bb5-9071-433c-9d2f-f805d4da2cf4". |
RepositoryId | string | Specifies the ID of the repository where the organization backups will be stored. For example, "repositoryId": "a740fb93-4de8-4de4-977e-765dd092748f". |
IsRun | bool | If set to True, the job will run right after it is created. For example, "IsRun": "true". |
Specify the following properties for the backup job schedule:
Property | Type | Description |
---|---|---|
Type | string | Specifies the job schedule type:
For example, "type": "daily". |
DailyType | string | Specifies the days when the backup job will run:
For example, "dailyType": "Sunday". |
DailyTime | UTC | Specifies the time when the job will start. For example, "dailyTime": "08:00:00" |
PeriodicInterval | string | Specifies the time interval between the job runs:
For example, "periodicallyEvery": "Hours1". |
BackupWindowEnabled | bool | If set to True, indicates that a backup window feature is enabled for this job. For example, "backupWindowEnabled": "true". |
BackupWindowSettings | Specifies the job's backup window settings. A backup window is a time period within which the job must be completed. | |
RetryEnabled | bool | If set to True, indicates that Veeam Backup for Microsoft Office 365 will attempt to restart a backup job if it fails for some reason. For example, "retryEnabled": "true". |
RetryNumber | int | Specifies the number of attempts to run the backup job. For example, "retryNumber": 5. |
RetryWait | int | Specifies the time intervals between the job retry attempts (minutes). For example, "retryWaitInterval": 15. |
For example:
"schedulePolicy": { "backupWindowEnabled": true, "backupWindowSettings": { "backupWindow": [ true, true, true, ... true ], "minuteOffset": 0 }, "type": "Daily", "dailyType": "Wednesday", "dailyTime": "08:00:00", "retryEnabled": true, "retryNumber": 3, "retryWaitInterval": 10 }, |
Specify the following property for the job's backup window:
Property | Type | Description |
---|---|---|
BackupWindow | bool | Specifies an hourly scheme for the backup window. The scheduling scheme consists of 168 boolean elements. These elements can be logically divided into 7 groups by 24. Each group represents a day of the week starting from Sunday. Each element represents a backup hour:
For example, to allow a backup job to run only on Sundays, set the first 24 elements to True. |
MinuteOffset | int | Specifies the current minute offset from the UTC time. For example, "minuteOffset": 15. |
For example:
"backupWindowSettings": { "backupWindow": [ true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false ], } |
Response
The server returns the following response to the client.
Response Codes
A successfully completed operation returns response code 201 Created.
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 request body message: application/json; charset=utf-8 |
Response Body
In the response body, the server returns a representation of the /Organizations/{ID}/Jobs resource. The resource has the following URL: /Jobs/{ID}.
Example 1
The example below shows how to backup an entire organization with ID 9b538005-3e78-4253-a84e-cc40630747cd.
Request: POST https://support.east.local:4443/v2/Organizations/9b538005-3e78-4253-a84e-cc40630747cd/Jobs
Request Header: Content-Type: application/json Authorization: Bearer <Access-Token>
Request Body: { "name": "job office365", "description": "", "backupType": "EntireOrganization", "schedulePolicy": { "backupWindowEnabled": false, "type": "Daily", "dailyType": "Everyday", "dailyTime": "01:00:00", "retryEnabled": true, "retryNumber": 3, "retryWaitInterval": 10 }, "RepositoryId": "2c9079b0-76b4-415f-bca8-de1450cedf79" }
Response: 201 Created
Response Body: { "id": "e8e3e9d5-29ba-41e6-bab7-25387149141f", "name": "job office365", "description": "", "nextRun": "2017-06-01T08:00:00Z", "isEnabled": true, "backupType": "EntireOrganization", "lastStatus": "Stopped", "schedulePolicy": { "backupWindowEnabled": false, "type": "Daily", "dailyType": "Everyday", "dailyTime": "01:00:00", "retryEnabled": true, "retryNumber": 3, "retryWaitInterval": 10 }, "_links": { "self": { "href": "https://support.east.local:4443/v2/jobs/e8e3e9d5-29ba-41e6-bab7-25287149141f" }, "organization": { "href": "https://support.east.local:4443/v2/organizations/9b538005-3e68-4263-a84e-cc40630747be" }, "backupRepository": { "href": "https://support.east.local:4443/v2/backuprepositories/ce18de31-329d-4f0f-b85e-4424cc2e6821" }, "jobsessions": { "href": "https://support.east.local:4443/v2/jobs/e8e3e9d5-29ba-42e6-bab7-25387149141f/jobsessions" }, "excludedItems": { "href": "https://support.east.local:4443/v2/jobs/e8e3e9d5-29ba-41e6-bab7-25387149141f/excludedItems" } } } |
Example 2
The example below shows how to backup selected items of an organization with ID 9b538005-3e78-4253-a84e-cc40630747cd.
Request: POST https://support.east.local:4443/v2/Organizations/9b538005-3e78-4253-a84e-cc40630747cd/Jobs
Request Header: Content-Type: application/json Authorization: Bearer <Access-Token>
Request Body: { "name": "job SelectedItems office365", "description": "", "nextRun": "2017-05-29T22:00:00Z", "isEnabled": true, "backupType": "SelectedItems", "SelectedItems": [ { "Type": "PartialOrganization", "Mailbox": true, "ArchiveMailbox": true, "OneDrive": true, "Site": true }, { "Type": "User", "User": { "id": "b583d2b8-c143-4b98-a769-fc95ebaa45f600000000-0000-0000-0000-000000000000", "displayName": "USER1", "name": "USER1@organization.onmicrosoft.com", "type": "User", "isBackedUp": false }, "Mailbox": true, "ArchiveMailbox": true, "OneDrive": true, "Site": true }, { "Type": "Group", "Group": { "id": "ca4b3d46-640f-4353-b59b-5beff743ca4c00000000-0000-0000-0000-000000000000", "displayName": "user 1550", "name": "user1550@organization.onmicrosoft.com", "managedBy": "USER1", "site": "https://organization.sharepoint.com/sites/SomeSite", "type": "Office365", "locationType": "Cloud", "isBackedup": false }, "Members": true, "MemberMail": true, "MemberArchive": false, "MemberOnedrive": true, "MemberSite": false, "Mail": true, "Site": false }, { "Type": "Site", "Site": { "id": "94f50108-75b4-4a5e-89ae-5651ee1e3975fdc607c4-6ac6-47d9-a1f3-cbdbc9766174", "url": "https://organization.sharepoint.com/sites/group2", "name": "Group 2", "isCloud": true, "title": "Group 2", "isBackedup": false, "isAvailable": true, } } ], "schedulePolicy": { "backupWindowEnabled": false, "type": "Daily", "dailyType": "Everyday", "dailyTime": "01:00:00", "retryEnabled": true, "retryNumber": 3, "retryWaitInterval": 10 }, "RepositoryId": "2c9079b0-76b4-415f-bca8-de1450cedf89" }
Response: 201 Created
Response Body: { "id": "e8e3e9d5-29ba-41e6-bab7-25387149141f", "name": "job office365", "description": "", "nextRun": "2017-06-01T08:00:00Z", "isEnabled": true, "backupType": "EntireOrganization", "lastStatus": "Stopped", "schedulePolicy": { "backupWindowEnabled": false, "type": "Daily", "dailyType": "Everyday", "dailyTime": "01:00:00", "retryEnabled": true, "retryNumber": 3, "retryWaitInterval": 10 }, "_links": { "self": { "href": "https://support.east.local:4443/v2/jobs/e8e3e9d5-29ba-41e6-bab7-25287149141f" }, "organization": { "href": "https://support.east.local:4443/v2/organizations/9b538005-3e68-4263-a84e-cc40630747be" }, "backupRepository": { "href": "https://support.east.local:4443/v2/backuprepositories/ce18de31-329d-4f0f-b85e-4424cc2e6821" }, "jobsessions": { "href": "https://support.east.local:4443/v2/jobs/e8e3e9d5-29ba-42e6-bab7-25387149141f/jobsessions" }, "excludedItems": { "href": "https://support.east.local:4443/v2/jobs/e8e3e9d5-29ba-41e6-bab7-25387149141f/excludedItems" } } } |