Getting Backup Job Items
You can get a resource representation of an item with the specified ID.
Request
GET https://<hostname>:4443/v5/Jobs/{jobId}/SelectedItems/{itemId} |
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 |
---|---|---|
jobId | string | An identification number of the backup job. |
itemId | string | An identification number of the item in the backup file. |
Request Body
None.
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: application/json; charset=utf-8 |
Response Body
The /Jobs/{jobId}/SelectedItems/{itemId} resource has the following properties:
Property | Type | Description |
---|---|---|
id | string | Specifies the ID of a backup item. |
type | Specifies the type of a backup item:
| |
_links | Dictionary of string [key] and Object [value] | Links to related resources (navigation property). |
Group
A backup item of the Group type has the following properties:
Property | Type | Description |
---|---|---|
group | group | Specifies the organization users group selected for this backup job. |
members | boolean | Specifies if this backup job will include Members processing option. |
memberMailbox | boolean | Specifies if this backup job will include Mailbox processing option. |
memberArchiveMailbox | boolean | Specifies if this backup job will include Archive Mailbox processing option. |
memberOneDrive | boolean | Specifies if this backup job will include OneDrive processing option. |
memberSite | boolean | Specifies if this backup job will include SharePoint sites processing option. |
groupMail | boolean | Specifies if this job will backup group mail. |
groupSite | boolean | Specifies if this job will backup group site. |
User
A backup item of the User type has the following properties:
Property | Type | Description |
---|---|---|
user | user | Specifies the organization user selected for this backup job. |
mailbox | boolean | Specifies if this backup job will include Mailbox processing option. |
archiveMailbox | boolean | Specifies if this backup job will include Archive Mailbox processing option. |
oneDrive | boolean | Specifies if this backup job will include OneDrive processing option. |
site | boolean | Specifies if this backup job will include SharePoint sites processing option. |
Site
A backup item of the Site type has the following properties:
Property | Type | Description |
---|---|---|
site | site | Specifies the organization SharePoint site selected for this backup job. |
Team
A backup item of the Team type has the following properties:
Property | Type | Description |
---|---|---|
team | team | Specifies the team included in the backup job. |
partialOrganization
A backup item of the partialOrganization type has the following properties:
Property | Type | Description |
---|---|---|
mailbox | boolean | Specifies if this backup job will include Mailbox processing option. |
archiveMailbox | boolean | Specifies if this backup job will include Archive Mailbox processing option. |
oneDrive | boolean | Specifies if this backup job will include OneDrive processing option. |
site | boolean | Specifies if this backup job will include SharePoint sites processing option. |
team | boolean | Specifies if this backup job will include Microsoft Teams processing option. |
personalSites
This type of a backup item does not have properties. If the personalSites backup item type is specified, all personal sites of an organization will be processed.
oneDriveFolders
A backup item of the oneDriveFolders type has the following properties:
Property | Type | Description |
---|---|---|
folders | string[] | Specifies a collection of OneDrive folders included in the backup job. Note: This property applies to all OneDrives in an organization. Only specified folders will be processed for each OneDrive. |
Examples
Example 1
Request: GET https://abc.tech.local:4443/v5/Jobs/31a66931-b5d3-49f7-bba1-c46db49d3d14/SelectedItems/c37da450-6c4b-48c4-87e2-cc557ef5d8975db60525-e59f-49b9-b49b-407fc9bf2642
Request Header: Authorization: Bearer <Access-Token>
Response: 200 OK
Response Body: { "type": "partialOrganization", "mailbox": true, "oneDrive": true, "archiveMailbox": true, "site": true, "id": "c37da450-6c4b-48c4-87e2-cc557ef5d8975db60525-e59f-49b9-b49b-407fc9bf2642", "_links": {} } |
Example 2
Request: GET https://abc.tech.local:4443/v5/Jobs/31a66931-b5d3-49f7-bba1-c46db49d3d14/SelectedItems/94f50108-75b4-4a5e-89ae-5651ee1e3975fdc607c4-6ac6-47d9-a1f3-cbdbc9766174
Request Header: Authorization: Bearer <Access-Token>
Response: 200 OK
Response Body: { "type": "Site", "site": { "id": "94f50108-75b4-4a5e-89ae-5651ee1e3975fdc607c4-6ac6-47d9-a1f3-cbdbc9766174", "url": "https://organization.sharepoint.com/sites/group2", "name": "Group 2", "isCloud": false, "isAvailable": false, "_links": { "organization": { "href": "https://abc.tech.local:4443/v5/organizations/5db60525-e59f-49b9-b49b-407fc9bf2642" } } }, "id": "e1fa728c-4150-4724-ab3b-5deda33db0cf94f50108-75b4-4a5e-89ae-5651ee1e3975fdc607c4-6ac6-47d9-a1f3-cbdbc9766174", "_links": { "job": { "href": "https://abc.tech.local:4443/v5/jobs/31a66931-b5d3-49f7-bba1-c46db49d3d14" } } } |
Example 3
Request: GET https://abc.tech.local:4443/v5/Jobs/31a66931-b5d3-49f7-bba1-c46db49d3d14/SelectedItems/ca4b3d46-640f-4353-b59b-5beff743ca4c00000000-0000-0000-0000-000000000000
Request Header: Authorization: Bearer <Access-Token>
Response: 200 OK
Response Body: { "type": "Group", "group": { "id": "ca4b3d46-640f-4353-b59b-5beff743ca4c00000000-0000-0000-0000-000000000000", "displayName": "USER", "name": "userAlpha@organization.onmicrosoft.com", "type": "Office365", "locationType": "OnPremises", "_links": { "self": { "href": "https://abc.tech.local:4443/v5/organizations/5db60525-e59f-49b9-b49b-407fc9bf2642/groups/ca4b3d46-640f-4353-b59b-5beff743ca4c00000000-0000-0000-0000-000000000000" }, "organization": { "href": "https://abc.tech.local:4443/v5/organizations/5db60525-e59f-49b9-b49b-407fc9bf2642" } } }, "members": true, "memberMail": true, "memberArchive": false, "memberOneDrive": true, "memberSite": true, "mail": true, "site": false, "id": "9592732d-22d8-426a-8167-d9635158e945ca4b3d46-640f-4353-b59b-5beff743ca4c00000000-0000-0000-0000-000000000000", "_links": { "job": { "href": "https://abc.tech.local:4443/v5/jobs/31a66931-b5d3-49f7-bba1-c46db49d3d14" } } } |
Example 4
Request: GET https://abc.tech.local:4443/v5/Jobs/31a66931-b5d3-49f7-bba1-c46db49d3d14/SelectedItems/b583d2b8-c143-4b98-a769-fc95ebaa45f600000000-0000-0000-0000-000000000000
Request Header: Authorization: Bearer <Access-Token>
Response: 200 OK
Response Body: { "type": "User", "user": { "id": "b583d2b8-c143-4b98-a769-fc95ebaa45f600000000-0000-0000-0000-000000000000", "displayName": "USER", "name": "userAlpha@organization.onmicrosoft.com", "type": "User", "_links": { "self": { "href": "https://abc.tech.local:4443/v5/organizations/5db60525-e59f-49b9-b49b-407fc9bf2642/users/b583d2b8-c143-4b98-a769-fc95ebaa45f600000000-0000-0000-0000-000000000000" }, "organization": { "href": "https://abc.tech.local:4443/v5/organizations/5db60525-e59f-49b9-b49b-407fc9bf2642" }, "onedrives": { "href": "https://abc.tech.local:4443/v5/organizations/5db60525-e59f-49b9-b49b-407fc9bf2642/users/b583d2b8-c143-4b98-a769-fc95ebaa45f600000000-0000-0000-0000-000000000000/onedrives" } } }, "mailbox": true, "oneDrive": true, "archiveMailbox": true, "site": true, "id": "2b38d840-8098-4614-b369-ebce33f9b2c7b583d2b8-c143-4b98-a769-fc95ebaa45f600000000-0000-0000-0000-000000000000", "_links": { "job": { "href": "https://abc.tech.local:4443/v5/jobs/31a66931-b5d3-49f7-bba1-c46db49d3d14" } } } |
Example 5
Request: GET https://abc.tech.local:4443/v5/Jobs/6707dfaa-4284-484a-8cbd-1ad2fe0d3dfc/SelectedItems/7b985334-bc0e-4791-b30c-d03a1fecc840448c5b66-8dcd-4c75-b636-d3b500bce36f
Request Header: Authorization: Bearer <Access-Token>
Response: 200 OK
Response Body: { "type": "Team", "team": { "id": "448c5b66-8dcd-4c75-b636-d3b500bce36f", "displayName": "IT&Finance", "description": "IT&Finance", "mail": "IT&Finance@organization.onmicrosoft.com", "_links": { "self": { "href": "https://abc.tech.local:4443/v5/organizations/3c424478-0811-4920-8aab-01f0bf2a2822/teams/448c5b66-8dcd-4c75-b636-d3b500bce36f" }, "organization": { "href": "https://abc.tech.local:4443/v5/organizations/3c424478-0811-4920-8aab-01f0bf2a2822" } } }, "id": "7b985334-bc0e-4791-b30c-d03a1fecc840448c5b66-8dcd-4c75-b636-d3b500bce36f", "_links": { "self": { "href": "https://abc.tech.local:4443/v5/jobs/6707dfaa-4284-484a-8cbd-1ad2fe0d3dfc/selectedItems/7b985334-bc0e-4791-b30c-d03a1fecc840448c5b66-8dcd-4c75-b636-d3b500bce36f" }, "job": { "href": "https://abc.tech.local:4443/v5/jobs/6707dfaa-4284-484a-8cbd-1ad2fe0d3dfc" } } } |
Example 6
Request: GET https://abc.tech.local:4443/v5/Jobs/6707dfaa-4284-484a-8cbd-1ad2fe0d3dfc/SelectedItems/7b985334-bc0e-4791-b30c-d03a1fecc840448c5b66-8dcd-4c75-b636-d3b500bce36f
Request Header: Authorization: Bearer <Access-Token>
Response: 200 OK
Response Body: { "type": "OneDriveFolders", "folders": [ "copyTo", "light\Document.docx" ] }, "id": "7b985334-bc0e-4791-b30c-d03a1fecc840448c5b66-8dcd-4c75-b636-d3b500bce36f", "_links": { "self": { "href": "https://abc.tech.local:4443/v5/jobs/6707dfaa-4284-484a-8cbd-1ad2fe0d3dfc/selectedItems/7b985334-bc0e-4791-b30c-d03a1fecc840448c5b66-8dcd-4c75-b636-d3b500bce36f" }, "job": { "href": "https://abc.tech.local:4443/v5/jobs/6707dfaa-4284-484a-8cbd-1ad2fe0d3dfc" } } } |