From cac4595b7a672ff9bcd10365767e09e97c99ce06 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Fri, 8 Nov 2024 15:42:14 +0530 Subject: [PATCH 001/144] Add files via upload --- .../beta/api/exchangerestoresession-get.md | 110 ++++++++++++++++++ 1 file changed, 110 insertions(+) create mode 100644 api-reference/beta/api/exchangerestoresession-get.md diff --git a/api-reference/beta/api/exchangerestoresession-get.md b/api-reference/beta/api/exchangerestoresession-get.md new file mode 100644 index 00000000000..75505af024a --- /dev/null +++ b/api-reference/beta/api/exchangerestoresession-get.md @@ -0,0 +1,110 @@ +--- +title: "Get exchangeRestoreSession" +description: "Read the properties and relationships of an exchangeRestoreSession object." +author: "**TODO: Provide GitHub Name. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +ms.localizationpriority: medium +ms.subservice: "**TODO: Add MS subservice. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" +doc_type: apiPageType +--- + +# Get exchangeRestoreSession + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Read the properties and relationships of an [exchangeRestoreSession](../resources/exchangerestoresession.md) object. + +## 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](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). + + +[!INCLUDE [permissions-table](../includes/permissions/exchangerestoresession-get-permissions.md)] + +## HTTP request + + +``` http +GET /solutions/backupRestore/exchangeRestoreSessions/{exchangeRestoreSessionId} +``` + +## Optional query parameters + +This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| + +## Request body + +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `200 OK` response code and an [exchangeRestoreSession](../resources/exchangerestoresession.md) object in the response body. + +## Examples + +### Request + +The following example shows a request. + +``` http +GET https://graph.microsoft.com/beta/solutions/backupRestore/exchangeRestoreSessions/{exchangeRestoreSessionId} +``` + + +### Response + +The following example shows the response. +>**Note:** The response object shown here might be shortened for readability. + +``` http +HTTP/1.1 200 OK +Content-Type: application/json + +{ + "value": { + "@odata.type": "#microsoft.graph.exchangeRestoreSession", + "id": "805176da-2882-e843-fe2f-4d260d92e2a1", + "status": "String", + "restoreJobType": "String", + "createdDateTime": "String (timestamp)", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "completedDateTime": "String (timestamp)", + "restoreSessionArtifactCount": { + "@odata.type": "microsoft.graph.restoreSessionArtifactCount" + }, + "lastModifiedDateTime": "String (timestamp)", + "lastModifiedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "error": { + "@odata.type": "microsoft.graph.publicError" + } + } +} +``` + From ba5d092642e51eeeddf9943734fc355d8116dd83 Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Thu, 7 Nov 2024 17:36:09 -0800 Subject: [PATCH 002/144] updated workforceIntegration, shifts, openshifts, enums, timeoff in v1 --- .../update-openshift-javascript-snippets.md | 41 ++-- .../changetrackedentity-stagefordeletion.md | 189 ++++++++++++++++++ api-reference/v1.0/api/openshift-get.md | 64 ++---- api-reference/v1.0/api/openshift-list.md | 87 ++++---- api-reference/v1.0/api/openshift-post.md | 93 +++------ api-reference/v1.0/api/openshift-update.md | 80 ++------ .../v1.0/api/schedule-list-shifts.md | 52 +---- .../v1.0/api/schedule-list-timeoffreasons.md | 49 +++-- .../v1.0/api/schedule-post-shifts.md | 101 +++------- .../v1.0/api/schedule-post-timesoff.md | 56 +++--- api-reference/v1.0/api/shift-get.md | 29 +-- api-reference/v1.0/api/shift-put.md | 116 ++--------- api-reference/v1.0/api/timeoff-get.md | 39 ++-- api-reference/v1.0/api/timeoff-put.md | 57 ++---- .../v1.0/api/workforceintegration-get.md | 30 ++- .../v1.0/api/workforceintegration-list.md | 32 +-- .../v1.0/api/workforceintegration-post.md | 48 +++-- .../v1.0/api/workforceintegration-update.md | 49 +++-- ...ckedentity-stagefordeletion-permissions.md | 6 + ...eintegration-from-teamwork-cli-snippets.md | 35 +++- .../cli/openshiftpost-cli-snippets.md | 13 +- .../cli/schedule-post-shifts-cli-snippets.md | 60 ++---- .../snippets/cli/timeoff-post-cli-snippets.md | 45 +++-- ...pdate-workforceintegration-cli-snippets.md | 35 +++- ...tegration-from-teamwork-csharp-snippets.md | 1 + .../csharp/openshiftpost-csharp-snippets.md | 20 +- .../schedule-post-shifts-csharp-snippets.md | 2 +- .../csharp/timeoff-post-csharp-snippets.md | 1 + ...te-workforceintegration-csharp-snippets.md | 1 + ...ceintegration-from-teamwork-go-snippets.md | 1 + .../snippets/go/openshiftpost-go-snippets.md | 25 +-- .../go/schedule-post-shifts-go-snippets.md | 4 +- .../snippets/go/timeoff-post-go-snippets.md | 2 + ...update-workforceintegration-go-snippets.md | 1 + ...integration-from-teamwork-java-snippets.md | 1 + .../java/openshiftpost-java-snippets.md | 17 +- .../schedule-post-shifts-java-snippets.md | 2 +- .../java/timeoff-post-java-snippets.md | 1 + ...date-workforceintegration-java-snippets.md | 1 + ...ation-from-teamwork-javascript-snippets.md | 1 + .../openshiftpost-javascript-snippets.md | 13 +- ...chedule-post-shifts-javascript-snippets.md | 56 ++---- .../shift-put-javascript-snippets.md | 67 ++----- .../timeoff-post-javascript-snippets.md | 1 + ...orkforceintegration-javascript-snippets.md | 3 +- ...eintegration-from-teamwork-php-snippets.md | 1 + .../php/openshiftpost-php-snippets.md | 16 +- .../php/schedule-post-shifts-php-snippets.md | 2 +- .../snippets/php/timeoff-post-php-snippets.md | 1 + ...pdate-workforceintegration-php-snippets.md | 1 + ...ation-from-teamwork-powershell-snippets.md | 1 + .../openshiftpost-powershell-snippets.md | 13 +- ...chedule-post-shifts-powershell-snippets.md | 2 +- .../timeoff-post-powershell-snippets.md | 1 + ...orkforceintegration-powershell-snippets.md | 1 + ...tegration-from-teamwork-python-snippets.md | 1 + .../python/openshiftpost-python-snippets.md | 15 +- .../schedule-post-shifts-python-snippets.md | 2 +- .../python/timeoff-post-python-snippets.md | 1 + ...te-workforceintegration-python-snippets.md | 1 + .../v1.0/resources/changetrackedentity.md | 19 +- api-reference/v1.0/resources/enums.md | 13 ++ api-reference/v1.0/resources/openshift.md | 29 ++- api-reference/v1.0/resources/openshiftitem.md | 19 +- api-reference/v1.0/resources/shift.md | 32 ++- api-reference/v1.0/resources/shiftactivity.md | 14 +- api-reference/v1.0/resources/timeoff.md | 28 ++- .../v1.0/resources/workforceintegration.md | 26 ++- 68 files changed, 893 insertions(+), 973 deletions(-) create mode 100644 api-reference/v1.0/api/changetrackedentity-stagefordeletion.md create mode 100644 api-reference/v1.0/includes/permissions/changetrackedentity-stagefordeletion-permissions.md diff --git a/api-reference/beta/includes/snippets/javascript/update-openshift-javascript-snippets.md b/api-reference/beta/includes/snippets/javascript/update-openshift-javascript-snippets.md index f3540fc271a..71a39bc9f51 100644 --- a/api-reference/beta/includes/snippets/javascript/update-openshift-javascript-snippets.md +++ b/api-reference/beta/includes/snippets/javascript/update-openshift-javascript-snippets.md @@ -11,29 +11,30 @@ const options = { const client = Client.init(options); const openShift = { -schedulingGroupId: 'TAG_228940ed-ff84-4e25-b129-1b395cf78be0', -sharedOpenShift: { -notes: 'Inventory Management', -openSlotCount: 5, -displayName: 'Field shift', -startDateTime: '2018-10-04T00:58:45.340Z', -endDateTime: '2018-10-04T09:50:45.332Z', -theme: 'white', -activities: [ -{ -isPaid: true, -startDateTime: '2018-10-04T00:58:45.340Z', -endDateTime: '2018-10-04T01:58:45.340Z', -code: '', -displayName: 'Lunch' -} -] -}, -draftOpenShift: null + schedulingGroupId: 'TAG_228940ed-ff84-4e25-b129-1b395cf78be0', + sharedOpenShift: { + notes: 'InventoryManagement', + openSlotCount: 2, + displayName: 'Dayshift', + startDateTime: '2018-10-04T00: 58: 45.340Z', + endDateTime: '2018-10-04T09: 50: 45.332Z', + theme: 'white', + activities: [ + { + isPaid: true, + startDateTime: '2018-10-04T00: 58: 45.340Z', + endDateTime: '2018-10-04T01: 58: 45.340Z', + code: '', + displayName: 'Lunch' + } + ] + }, + draftOpenShift: null, + isStagedForDeletion: false, }; + await client.api('/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/openShifts/OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8') - .version('beta') .put(openShift); ``` \ No newline at end of file diff --git a/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md b/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md new file mode 100644 index 00000000000..5f0d5ecd22b --- /dev/null +++ b/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md @@ -0,0 +1,189 @@ +--- +title: "changeTrackedEntity: stageForDeletion" +description: "Stage the deletion of an openShift, shift, or timeOff instance in a [schedule](../resources/schedule.md) in draft mode." +author: "raulfernandes" +ms.localizationpriority: medium +ms.subservice: "teams" +doc_type: apiPageType +--- + +# changeTrackedEntity: stageForDeletion + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Stage the deletion of an [openShift](../resources/openshift.md), [shift](../resources/shift.md), or [timeOff](../resources/timeoff.md) instance in a [schedule](../resources/schedule.md) in draft mode. + +Draft changes are only visible to managers. Team members aren't sent notification for draft changes. The deletion is finalized when the schedule is [shared](../api/schedule-share.md). + +## Permissions + +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). + + +[!INCLUDE [permissions-table](../includes/permissions/changetrackedentity-stagefordeletion-permissions.md)] + +## HTTP request + +For an **openShift**: + +``` http +POST /teams/{teamsId}/schedule/openShifts/{openShiftId}/stageForDeletion +``` + +For a **shift**: + +``` http +POST /teams/{teamsId}/schedule/shifts/{shiftId}/stageForDeletion +``` + +For a **timeOff**: + +``` http +POST /teams/{teamsId}/schedule/timesOff/{timeOffId}/stageForDeletion +``` + +## Request headers + +|Name|Description| +|:---|:---| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +| MS-APP-ACTS-AS | A user ID (GUID). Required only if the authorization token is an application token; otherwise, optional. | + +## Request body + +Don't supply a request body for this method. + +## Response + +If successful, this method returns a `204 No Content` response code. + +## Examples + +### Example 1: Stage the deletion of an openShift + +The following example shows how to stage the deletion of an **openShift** in a **schedule** in draft mode. + +#### Request + +The following example shows a request. + +# [HTTP](#tab/http) + +``` http +POST https://graph.microsoft.com/beta/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/openShifts/OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion +``` + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/openshiftstagefordeletion-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + +#### Response + +The following example shows the response. + + +``` http +HTTP/1.1 204 No Content +``` + +### Example 2: Stage the deletion of a shift + +The following example shows how to stage the deletion of a **shift** in a **schedule** in draft mode. + +#### Request + +The following example shows a request. + +# [HTTP](#tab/http) + +``` http +POST https://graph.microsoft.com/beta/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/shifts/SHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion +``` + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/shiftstagefordeletion-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + +#### Response + +The following example shows the response. + + +``` http +HTTP/1.1 204 No Content +``` + +### Example 3: Stage the deletion of a timeOff + +The following example shows how to stage the deletion of a **timeOff** in a **schedule** in draft mode. + +#### Request + +The following example shows a request. + +# [HTTP](#tab/http) + +``` http +POST https://graph.microsoft.com/beta/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/timesOff/SHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion +``` + +# [JavaScript](#tab/javascript) +[!INCLUDE [sample-code](../includes/snippets/javascript/timeoffstagefordeletion-javascript-snippets.md)] +[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] + +--- + +#### Response + +The following example shows the response. + + +``` http +HTTP/1.1 204 No Content +``` diff --git a/api-reference/v1.0/api/openshift-get.md b/api-reference/v1.0/api/openshift-get.md index f32b0f973f8..1d5eb8c5073 100644 --- a/api-reference/v1.0/api/openshift-get.md +++ b/api-reference/v1.0/api/openshift-get.md @@ -116,56 +116,24 @@ The following example shows the response. ```http HTTP/1.1 200 OK -Content-type: application/json +Content-Type: application/json { - "id": "OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8", - "schedulingGroupId": "TAG_228940ed-ff84-4e25-b129-1b395cf78be0", - "sharedOpenShift": { - "notes": "Inventory Management", - "openSlotCount":2, - "displayName": "Day shift", - "startDateTime": "2018-10-04T00:58:45.340Z", - "endDateTime": "2018-10-04T09:50:45.332Z", - "theme": "white", - "activities": [ - { - "isPaid": true, - "startDateTime": "2018-10-04T00:58:45.340Z", - "endDateTime": "2018-10-04T01:58:45.340Z", - "code": "", - "displayName": "Lunch" - } - ] - }, - "draftOpenShift": { - "notes": "Inventory Management", - "openSlotCount":3, - "displayName": "Day shift", - "startDateTime": "2018-10-04T00:58:45.332Z", - "endDateTime": "2018-10-04T08:58:45.340Z", - "theme": "white", - "activities": [ - { - "isPaid": true, - "startDateTime": "2018-10-04T00:58:45.340Z", - "endDateTime": "2018-10-04T07:58:45.332Z", - "code": "Break", - "displayName": "Lunch" - } - ] - }, - "createdDateTime": "2019-03-14T04:32:51.451Z", - "lastModifiedDateTime": "2019-03-14T05:32:51.451Z", - "lastModifiedBy": { - "application": null, - "device": null, - "conversation": null, - "user": { - "id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8", - "displayName": "John Doe" - } - } + "@odata.type": "#microsoft.graph.openShift", + "id": "String (identifier)", + "createdDateTime": "String (timestamp)", + "lastModifiedDateTime": "String (timestamp)", + "lastModifiedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "sharedOpenShift": { + "@odata.type": "microsoft.graph.openShiftItem" + }, + "draftOpenShift": { + "@odata.type": "microsoft.graph.openShiftItem" + }, + "schedulingGroupId": "String", + "isStagedForDeletion": "Boolean" } ``` diff --git a/api-reference/v1.0/api/openshift-list.md b/api-reference/v1.0/api/openshift-list.md index 0518dfead37..7e1ec76b5a0 100644 --- a/api-reference/v1.0/api/openshift-list.md +++ b/api-reference/v1.0/api/openshift-list.md @@ -119,57 +119,42 @@ HTTP/1.1 200 OK Content-type: application/json { - "value": [ - { - "id": "OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8", - "schedulingGroupId": "TAG_228940ed-ff84-4e25-b129-1b395cf78be0", - "sharedOpenShift": { - "notes": "Inventory Management", - "openSlotCount": 2, - "displayName": "Day shift", - "startDateTime": "2018-10-04T00:58:45.340Z", - "endDateTime": "2018-10-04T09:50:45.332Z", - "theme": "white", - "activities": [ - { - "isPaid": true, - "startDateTime": "2018-10-04T00:58:45.340Z", - "endDateTime": "2018-10-04T01:58:45.340Z", - "code": "", - "displayName": "Lunch" - } - ] - }, - "draftOpenShift": { - "notes": "Inventory Management", - "openSlotCount": 3, - "displayName": "Day shift", - "startDateTime": "2018-10-04T00:58:45.332Z", - "endDateTime": "2018-10-04T08:58:45.340Z", - "theme": "white", - "activities": [ - { - "isPaid": true, - "startDateTime": "2018-10-04T00:58:45.340Z", - "endDateTime": "2018-10-04T07:58:45.332Z", - "code": "Break", - "displayName": "Lunch" - } - ] - }, - "createdDateTime": "2019-03-14T04:32:51.451Z", - "lastModifiedDateTime": "2019-03-14T05:32:51.451Z", - "lastModifiedBy": { - "application": null, - "device": null, - "conversation": null, - "user": { - "id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8", - "displayName": "John Doe" - } - } - } - ] + "value": [ + { + "@odata.type": "#microsoft.graph.openShift", + "id": "String (identifier)", + "createdDateTime": "String (timestamp)", + "lastModifiedDateTime": "String (timestamp)", + "lastModifiedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "sharedOpenShift": { + "@odata.type": "microsoft.graph.openShiftItem" + }, + "draftOpenShift": { + "@odata.type": "microsoft.graph.openShiftItem" + }, + "schedulingGroupId": "String", + "isStagedForDeletion": "Boolean" + }, + { + "@odata.type": "#microsoft.graph.openShift", + "id": "String (identifier)", + "createdDateTime": "String (timestamp)", + "lastModifiedDateTime": "String (timestamp)", + "lastModifiedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "sharedOpenShift": { + "@odata.type": "microsoft.graph.openShiftItem" + }, + "draftOpenShift": { + "@odata.type": "microsoft.graph.openShiftItem" + }, + "schedulingGroupId": "String", + "isStagedForDeletion": "Boolean" + } + ] } ``` diff --git a/api-reference/v1.0/api/openshift-post.md b/api-reference/v1.0/api/openshift-post.md index 2e7ee37dd39..e1b412a9aaa 100644 --- a/api-reference/v1.0/api/openshift-post.md +++ b/api-reference/v1.0/api/openshift-post.md @@ -42,7 +42,14 @@ POST /teams/{id}/schedule/openShifts ## Request body -Provide the new [openShift](../resources/openshift.md) object in the request body for this method. +Provide the modified [openShift](../resources/openshift.md) object in the request body for this method. + +|Property|Type|Description| +|:---|:---|:---| +| draftOpenShift | [openShiftItem](openshiftitem.md) | Draft changes in the **openShift** are only visible to managers until they're [shared](../api/schedule-share.md). Either sharedOpenShift or sharedOpenShift should be null| +| isStagedForDeletion | Boolean | The **openShift** is marked for deletion, a process that is finalized when the schedule is [shared](../api/schedule-share.md). Optional. | +| schedulingGroupId | String | The ID of the [schedulingGroup](schedulinggroup.md) that contains the **openShift**. | +| sharedOpenShift | [openShiftItem](openshiftitem.md) | The shared version of this **openShift** that is viewable by both employees and managers. Either sharedOpenShift or sharedOpenShift should be null| ## Response @@ -64,37 +71,15 @@ Authorization: Bearer {token} Content-type: application/json { - "id":"OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8", - "schedulingGroupId":"TAG_228940ed-ff84-4e25-b129-1b395cf78be0", - "sharedOpenShift":{ - "notes":"InventoryManagement", - "openSlotCount":2, - "displayName":"Dayshift", - "startDateTime":"2018-10-04T00: 58: 45.340Z", - "endDateTime":"2018-10-04T09: 50: 45.332Z", - "theme":"white", - "activities":[ - { - "isPaid":true, - "startDateTime":"2018-10-04T00: 58: 45.340Z", - "endDateTime":"2018-10-04T01: 58: 45.340Z", - "code":"", - "displayName":"Lunch" - } - ] - }, - "draftOpenShift":null, - "createdDateTime":"2019-03-14T04: 32: 51.451Z", - "lastModifiedDateTime":"2019-03-14T05: 32: 51.451Z", - "lastModifiedBy":{ - "application":null, - "device":null, - "conversation":null, - "user":{ - "id":"366c0b19-49b1-41b5-a03f-9f3887bd0ed8", - "displayName":"JohnDoe" - } - } + "@odata.type": "#microsoft.graph.openShift", + "sharedOpenShift": { + "@odata.type": "microsoft.graph.openShiftItem" + }, + "draftOpenShift": { + "@odata.type": "microsoft.graph.openShiftItem" + }, + "schedulingGroupId": "String", + "isStagedForDeletion": "Boolean" } ``` @@ -146,40 +131,24 @@ The following example shows the response. ```http HTTP/1.1 200 OK -Content-type: application/json +Content-Type: application/json { - "id": "OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8", - "schedulingGroupId": "TAG_228940ed-ff84-4e25-b129-1b395cf78be0", + "@odata.type": "#microsoft.graph.openShift", + "id": "String (identifier)", + "createdDateTime": "String (timestamp)", + "lastModifiedDateTime": "String (timestamp)", + "lastModifiedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, "sharedOpenShift": { - "notes": "Inventory Management", - "openSlotCount":2, - "displayName": "Day shift", - "startDateTime": "2018-10-04T00:58:45.340Z", - "endDateTime": "2018-10-04T09:50:45.332Z", - "theme": "white", - "activities": [ - { - "isPaid": true, - "startDateTime": "2018-10-04T00:58:45.340Z", - "endDateTime": "2018-10-04T01:58:45.340Z", - "code": "", - "displayName": "Lunch" - } - ] + "@odata.type": "microsoft.graph.openShiftItem" }, - "draftOpenShift": null, - "createdDateTime": "2019-03-14T04:32:51.451Z", - "lastModifiedDateTime": "2019-03-14T05:32:51.451Z", - "lastModifiedBy": { - "application": null, - "device": null, - "conversation": null, - "user": { - "id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8", - "displayName": "John Doe" - } - } + "draftOpenShift": { + "@odata.type": "microsoft.graph.openShiftItem" + }, + "schedulingGroupId": "String", + "isStagedForDeletion": "Boolean" } ``` diff --git a/api-reference/v1.0/api/openshift-update.md b/api-reference/v1.0/api/openshift-update.md index 63636246e9b..b7a816d1076 100644 --- a/api-reference/v1.0/api/openshift-update.md +++ b/api-reference/v1.0/api/openshift-update.md @@ -42,11 +42,12 @@ PUT /teams/{id}/schedule/openShifts/{openShiftId} Provide the modified [openShift](../resources/openshift.md) object in the request body for this method. -| Property | Type | Description | -|:-------------|:------------|:------------| -|draftOpenShift|openShiftItem|An unpublished open shift.| -|schedulingGroupId|String| Scheduling group ID. | -|sharedOpenShift|openShiftItem|A published open shift.| +|Property|Type|Description| +|:---|:---|:---| +| draftOpenShift | [openShiftItem](openshiftitem.md) | Draft changes in the **openShift** are only visible to managers until they're [shared](../api/schedule-share.md). Either sharedOpenShift or sharedOpenShift should be null.| +| isStagedForDeletion | Boolean | The **openShift** is marked for deletion, a process that is finalized when the schedule is [shared](../api/schedule-share.md). Optional. | +| schedulingGroupId | String | The ID of the [schedulingGroup](schedulinggroup.md) that contains the **openShift**. | +| sharedOpenShift | [openShiftItem](openshiftitem.md) | The shared version of this **openShift** that is viewable by both employees and managers. Either sharedOpenShift or sharedOpenShift should be null.| ## Response @@ -67,29 +68,19 @@ The following example shows a request. }--> ```http -PUT https://graph.microsoft.com/v1.0/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/openShifts/OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8 -Content-type: application/json +PATCH https://graph.microsoft.com/v1.0/team/schedule/openShifts/{openShiftId} +Content-Type: application/json { -"schedulingGroupId": "TAG_228940ed-ff84-4e25-b129-1b395cf78be0", -"sharedOpenShift": { -"notes": "Inventory Management", -"openSlotCount":5, -"displayName": "Field shift", -"startDateTime": "2018-10-04T00:58:45.340Z", -"endDateTime": "2018-10-04T09:50:45.332Z", -"theme": "white", -"activities": [ -{ -"isPaid": true, -"startDateTime": "2018-10-04T00:58:45.340Z", -"endDateTime": "2018-10-04T01:58:45.340Z", -"code": "", -"displayName": "Lunch" -} -] -}, -"draftOpenShift": null + "@odata.type": "#microsoft.graph.openShift", + "sharedOpenShift": { + "@odata.type": "microsoft.graph.openShiftItem" + }, + "draftOpenShift": { + "@odata.type": "microsoft.graph.openShiftItem" + }, + "schedulingGroupId": "String", + "isStagedForDeletion": "Boolean" } ``` @@ -112,42 +103,7 @@ The following example shows the response. } --> ```http -HTTP/1.1 200 OK -Content-type: application/json - -{ - "id": "OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8", - "schedulingGroupId": "TAG_228940ed-ff84-4e25-b129-1b395cf78be0", - "sharedOpenShift": { - "notes": "Inventory Management", - "openSlotCount":5, - "displayName": "Day shift", - "startDateTime": "2018-10-04T00:58:45.340Z", - "endDateTime": "2018-10-04T09:50:45.332Z", - "theme": "white", - "activities": [ - { - "isPaid": true, - "startDateTime": "2018-10-04T00:58:45.340Z", - "endDateTime": "2018-10-04T01:58:45.340Z", - "code": "", - "displayName": "Lunch" - } - ] - }, - "draftOpenShift": null, - "createdDateTime": "2019-03-14T04:32:51.451Z", - "lastModifiedDateTime": "2019-03-14T05:32:51.451Z", - "lastModifiedBy": { - "application": null, - "device": null, - "conversation": null, - "user": { - "id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8", - "displayName": "John Doe" - } - } -} +HTTP/1.1 204 No Content ``` ```http -HTTP/1.1 200 OK -Content-type: application/json - -{ - "id": "string", - "userId": "string", - "schedulingGroupId": "string", - "sharedShift": { - "notes": "string", - "displayName": "string", - "startDateTime": "2018-10-04T00:58:45.340Z", - "endDateTime": "2018-10-04T00:58:45.340Z", - "theme": "white", - "activities": [ - { - "isPaid": true, - "startDateTime": "2018-10-04T00:58:45.340Z", - "endDateTime": "2018-10-04T00:58:45.340Z", - "code": "string", - "displayName": "string" - } - ] - }, - "draftShift": { - "notes": "string", - "displayName": "string", - "startDateTime": "2018-10-04T00:58:45.340Z", - "endDateTime": "2018-10-04T00:58:45.340Z", - "theme": "white", - "activities": [ - { - "isPaid": true, - "startDateTime": "2018-10-04T00:58:45.340Z", - "endDateTime": "2018-10-04T00:58:45.340Z", - "code": "string", - "displayName": "string" - } - ] - }, - "createdDateTime": "2018-10-04T00:58:45.340Z", - "lastModifiedDateTime": "2018-10-04T00:58:45.340Z", - "lastModifiedBy": { - "user": { - "id": "string", - "displayName": "string" - }, - "application": { - "id": "string", - "displayName": "string" - }, - "device": { - "id": "string", - "displayName": "string" - } - } -} +HTTP/1.1 204 No Content ``` ```http -HTTP/1.1 200 OK -Content-type: application/json - -{ - "userId": "c5d0c76b-80c4-481c-be50-923cd8d680a1", - "createdDateTime": "2019-03-14T05:35:57.755Z", - "lastModifiedDateTime": "2019-03-14T05:36:08.381Z", - "lastModifiedBy": { - "@odata.type":"microsoft.graph.identitySet", - "application": null, - "device": null, - "conversation": null, - "user": { - "id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8", - "displayName": "John Doe" - } - }, - "sharedTimeOff": { - "timeOffReasonId": "TOR_891045ca-b5d2-406b-aa06-a3c8921245d7", - "startDateTime": "2019-03-11T07:00:00Z", - "endDateTime": "2019-03-12T07:00:00Z", - "theme": "white" - }, - "draftTimeOff": { - "timeOffReasonId": "TOR_891045ca-b5d2-406b-aa06-a3c8921245d7", - "startDateTime": "2019-03-11T07:00:00Z", - "endDateTime": "2019-03-12T07:00:00Z", - "theme": "pink" - } -} +HTTP/1.1 204 No Content ``` ```json { - "isPaid": true, - "startDateTime": "2019-03-11T15:00:00Z", - "endDateTime": "2019-03-11T15:15:00Z", - "code": "", - "displayName": "Lunch" + "@odata.type": "#microsoft.graph.shiftActivity", + "isPaid": "Boolean", + "startDateTime": "String (timestamp)", + "endDateTime": "String (timestamp)", + "code": "String", + "displayName": "String", + "theme": "String" } ``` diff --git a/api-reference/v1.0/resources/timeoff.md b/api-reference/v1.0/resources/timeoff.md index 1549590702b..a43ede5fe45 100644 --- a/api-reference/v1.0/resources/timeoff.md +++ b/api-reference/v1.0/resources/timeoff.md @@ -22,15 +22,17 @@ Represents a unit of non-work in a [schedule](../resources/schedule.md). |[Get](../api/timeoff-get.md) | [timeOff](timeoff.md) | Get a **timeOff** object by ID.| |[Replace](../api/timeoff-put.md) | [timeOff](timeoff.md) | Replace a **timeOff** object.| |[Delete](../api/timeoff-delete.md) | None | Delete a **timeOff** object from the schedule.| +|[Stage for deletion](../api/changetrackedentity-stagefordeletion.md)| None |Stage the deletion of a [timeOff](timeoff.md) in a [schedule](schedule.md) in draft mode.| ## Properties |Name |Type |Description | |--------------|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------| -| createdDateTime | DateTimeOffset |The time stamp at which this **timeOff** was first created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. | +| createdDateTime | DateTimeOffset |The time stamp at which this **timeOff** was first created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [changeTrackedEntity](../resources/changetrackedentity.md).| | draftTimeOff | [timeOffItem](timeoffitem.md) |The draft version of this **timeOff** item that is viewable by managers. It must be shared before it is visible to team members. Required.| -| id | String |ID of the **timeOff**.| -| lastModifiedBy | [identitySet](identityset.md) |The identity that last updated this **timeOff**. | -| lastModifiedDateTime | DateTimeOffset |The time stamp at which this **timeOff** was last updated. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. | +| id | String |ID of the **timeOff**. Inherited from [changeTrackedEntity](../resources/changetrackedentity.md).| +| isStagedForDeletion | Boolean | The **timeOff** is marked for deletion, a process that is finalized when the schedule is [shared](../api/schedule-share.md). | +| lastModifiedBy | [identitySet](identityset.md) |The identity that last updated this **timeOff**. Inherited from [changeTrackedEntity](../resources/changetrackedentity.md).| +| lastModifiedDateTime | DateTimeOffset |The time stamp at which this **timeOff** was last updated. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [changeTrackedEntity](../resources/changetrackedentity.md).| | sharedTimeOff | [timeOffItem](timeoffitem.md) |The shared version of this **timeOff** that is viewable by both employees and managers. Updates to the **sharedTimeOff** property send notifications to users in the Teams client. Required.| | userId | String |ID of the user assigned to the **timeOff**. Required.| @@ -47,13 +49,21 @@ The following JSON representation shows the resource type. ```json { - "createdDateTime": "String (timestamp)", - "draftTimeOff": {"@odata.type": "microsoft.graph.timeOffItem"}, + "@odata.type": "#microsoft.graph.timeOff", "id": "String (identifier)", - "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"}, + "createdDateTime": "String (timestamp)", "lastModifiedDateTime": "String (timestamp)", - "sharedTimeOff": {"@odata.type": "microsoft.graph.timeOffItem"}, - "userId": "String" + "lastModifiedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "sharedTimeOff": { + "@odata.type": "microsoft.graph.timeOffItem" + }, + "draftTimeOff": { + "@odata.type": "microsoft.graph.timeOffItem" + }, + "userId": "String", + "isStagedForDeletion": "Boolean" } ``` diff --git a/api-reference/v1.0/resources/workforceintegration.md b/api-reference/v1.0/resources/workforceintegration.md index 9ae2eaa2540..dced3dafb54 100644 --- a/api-reference/v1.0/resources/workforceintegration.md +++ b/api-reference/v1.0/resources/workforceintegration.md @@ -28,10 +28,12 @@ An instance of a workforce integration with shifts. | Property | Type | Description | |:-------------|:------------|:------------| |apiVersion|Int32|API version for the call back URL. Start with 1.| +|createdDateTime|DateTimeOffset|Inherited from [changeTrackedEntity](../resources/changetrackedentity.md).| |displayName|String|Name of the workforce integration.| +|eligibilityFilteringEnabledEntities|eligibilityFilteringEnabledEntities| Support to view eligibility-filtered results. Possible values are: `none`, `swapRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason`.| |encryption|[workforceIntegrationEncryption](workforceintegrationencryption.md)|The workforce integration encryption resource.| |isActive|Boolean|Indicates whether this workforce integration is currently active and available.| -|supportedEntities|workforceIntegrationSupportedEntities | The Shifts entities supported for synchronous change notifications. Shifts will make a call back to the url provided on client changes on those entities added here. By default, no entities are supported for change notifications. Possible values are: `none`, `shift`, `swapRequest`, `userShiftPreferences`, `openshift`, `openShiftRequest`, `offerShiftRequest`, `unknownFutureValue`.| +|supportedEntities|workforceIntegrationSupportedEntities | The Shifts entities supported for synchronous change notifications. Shifts will make a call back to the url provided on client changes on those entities added here. By default, no entities are supported for change notifications. Possible values are: `none`, `shift`, `swapRequest`, `userShiftPreferences`, `openShift`, `openShiftRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`, `timeOff`, `timeOffRequest`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason` , `timeOff` , `timeOffRequest`.| |url|String| Workforce Integration URL for callbacks from the Shifts service.| ## Relationships @@ -50,14 +52,24 @@ The following JSON representation shows the resource type. "@odata.type": "microsoft.graph.workforceIntegration" }--> -```json +``` json { - "apiVersion": 1024, + "@odata.type": "#microsoft.graph.workforceIntegration", + "id": "String (identifier)", + "createdDateTime": "String (timestamp)", + "lastModifiedDateTime": "String (timestamp)", + "lastModifiedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, "displayName": "String", - "encryption": {"@odata.type": "microsoft.graph.workforceIntegrationEncryption"}, - "isActive": true, - "supportedEntities": "string", - "url": "String" + "apiVersion": "Integer", + "encryption": { + "@odata.type": "microsoft.graph.workforceIntegrationEncryption" + }, + "isActive": "Boolean", + "url": "String", + "supportedEntities": "String", + "eligibilityFilteringEnabledEntities": "String" } ``` From 7a3b93c9f640d820d72534066304933f4ce01cf7 Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Fri, 8 Nov 2024 16:01:42 -0800 Subject: [PATCH 003/144] change back to real example --- api-reference/v1.0/api/openshift-post.md | 55 ++++++++++------ api-reference/v1.0/api/openshift-update.md | 21 +++--- .../v1.0/api/schedule-post-shifts.md | 64 +++++++++++-------- .../v1.0/api/schedule-post-timesoff.md | 57 ++++++++++------- api-reference/v1.0/api/shift-put.md | 21 +++--- api-reference/v1.0/api/timeoff-put.md | 17 +++-- .../v1.0/api/workforceintegration-post.md | 50 +++++++-------- .../v1.0/api/workforceintegration-update.md | 41 +++++------- 8 files changed, 178 insertions(+), 148 deletions(-) diff --git a/api-reference/v1.0/api/openshift-post.md b/api-reference/v1.0/api/openshift-post.md index e1b412a9aaa..3e0d77f657f 100644 --- a/api-reference/v1.0/api/openshift-post.md +++ b/api-reference/v1.0/api/openshift-post.md @@ -71,15 +71,18 @@ Authorization: Bearer {token} Content-type: application/json { - "@odata.type": "#microsoft.graph.openShift", - "sharedOpenShift": { - "@odata.type": "microsoft.graph.openShiftItem" - }, - "draftOpenShift": { - "@odata.type": "microsoft.graph.openShiftItem" - }, - "schedulingGroupId": "String", - "isStagedForDeletion": "Boolean" + "schedulingGroupId": "TAG_4ab7d329-1f7e-4eaf-ba93-63f1ff3f3c4a", + "sharedOpenShift": { + "displayName": null, + "startDateTime": "2024-11-04T20:00:00Z", + "endDateTime": "2024-11-04T21:00:00Z", + "theme": "blue", + "notes": null, + "openSlotCount": 1, + "activities": [] + }, + "draftTimeOff": null, + "isStagedForDeletion": false } ``` @@ -134,21 +137,33 @@ HTTP/1.1 200 OK Content-Type: application/json { - "@odata.type": "#microsoft.graph.openShift", - "id": "String (identifier)", - "createdDateTime": "String (timestamp)", - "lastModifiedDateTime": "String (timestamp)", + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('48ba9e52-8d25-41c7-bbe7-5ee6346eec0d')/schedule/openShifts/$entity", + "@odata.etag": "\"4002def0-0000-0c00-0000-672ea2ff0000\"", + "id": "OPNSHFT_6f5e1d7c-3ebe-449f-abfc-d677d26f0b5c", + "createdDateTime": "2024-11-08T23:47:11.605Z", + "lastModifiedDateTime": "2024-11-08T23:47:11.605Z", + "schedulingGroupId": "TAG_4ab7d329-1f7e-4eaf-ba93-63f1ff3f3c4a", + "draftOpenShift": null, "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" + "application": null, + "device": null, + "user": { + "id": "aa162a04-bec6-4b81-ba99-96caa7b2b24d", + "displayName": "victorcheng", + "userIdentityType": "aadUser", + "tenantId": null + } }, "sharedOpenShift": { - "@odata.type": "microsoft.graph.openShiftItem" - }, - "draftOpenShift": { - "@odata.type": "microsoft.graph.openShiftItem" + "displayName": null, + "startDateTime": "2024-11-04T20:00:00Z", + "endDateTime": "2024-11-04T21:00:00Z", + "theme": "blue", + "notes": null, + "openSlotCount": 1, + "activities": [] }, - "schedulingGroupId": "String", - "isStagedForDeletion": "Boolean" + isStagedForDeletion: false } ``` diff --git a/api-reference/v1.0/api/openshift-update.md b/api-reference/v1.0/api/openshift-update.md index b7a816d1076..85ea8737384 100644 --- a/api-reference/v1.0/api/openshift-update.md +++ b/api-reference/v1.0/api/openshift-update.md @@ -72,15 +72,18 @@ PATCH https://graph.microsoft.com/v1.0/team/schedule/openShifts/{openShiftId} Content-Type: application/json { - "@odata.type": "#microsoft.graph.openShift", - "sharedOpenShift": { - "@odata.type": "microsoft.graph.openShiftItem" - }, - "draftOpenShift": { - "@odata.type": "microsoft.graph.openShiftItem" - }, - "schedulingGroupId": "String", - "isStagedForDeletion": "Boolean" + "schedulingGroupId": "TAG_4ab7d329-1f7e-4eaf-ba93-63f1ff3f3c4a", + "sharedOpenShift": { + "displayName": null, + "startDateTime": "2024-11-04T20:00:00Z", + "endDateTime": "2024-11-04T21:00:00Z", + "theme": "blue", + "notes": null, + "openSlotCount": 1, + "activities": [] + }, + "draftTimeOff": null, + "isStagedForDeletion": false } ``` diff --git a/api-reference/v1.0/api/schedule-post-shifts.md b/api-reference/v1.0/api/schedule-post-shifts.md index 1fdccf74ef5..d67fa9ffe84 100644 --- a/api-reference/v1.0/api/schedule-post-shifts.md +++ b/api-reference/v1.0/api/schedule-post-shifts.md @@ -71,16 +71,17 @@ POST https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/shifts Content-type: application/json { - "@odata.type": "#microsoft.graph.shift", - "sharedShift": { - "@odata.type": "microsoft.graph.shiftItem" - }, - "draftShift": { - "@odata.type": "microsoft.graph.shiftItem" - }, - "userId": "String", - "schedulingGroupId": "String", - "isStagedForDeletion": "Boolean" + "userId": "5ca83ce7-291d-43b7-bf53-af79eef4bc1d", + "draftShift": { + "displayName": null, + "startDateTime": "2024-10-08T15:00:00Z", + "endDateTime": "2024-10-09T00:00:00Z", + "theme": "blue", + "notes": null, + "activities": [] + }, + "sharedShift": null, + "isStagedForDeletion": false } ``` @@ -134,22 +135,33 @@ HTTP/1.1 201 Created Content-type: application/json { - "@odata.type": "#microsoft.graph.shift", - "id": "179a8570-a463-293f-15a2-0bba4cdca4d8", - "createdDateTime": "String (timestamp)", - "lastModifiedDateTime": "String (timestamp)", - "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" - }, - "sharedShift": { - "@odata.type": "microsoft.graph.shiftItem" - }, - "draftShift": { - "@odata.type": "microsoft.graph.shiftItem" - }, - "userId": "String", - "schedulingGroupId": "String", - "isStagedForDeletion": "Boolean" + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('48ba9e52-8d25-41c7-bbe7-5ee6346eec0d')/schedule/shifts/$entity", + "@odata.etag": "\"40022efe-0000-0c00-0000-672ea37a0000\"", + "id": "SHFT_0f004eda-32a6-4f0c-a076-18f76d997a55", + "createdDateTime": "2024-11-08T23:49:13.877Z", + "lastModifiedDateTime": "2024-11-08T23:49:13.877Z", + "schedulingGroupId": null, + "userId": "5ca83ce7-291d-43b7-bf53-af79eef4bc1d", + "sharedShift": null, + "lastModifiedBy": { + "application": null, + "device": null, + "user": { + "id": "aa162a04-bec6-4b81-ba99-96caa7b2b24d", + "displayName": "victorcheng", + "userIdentityType": "aadUser", + "tenantId": null + } + }, + "draftShift": { + "displayName": null, + "startDateTime": "2024-10-08T15:00:00Z", + "endDateTime": "2024-10-09T00:00:00Z", + "theme": "blue", + "notes": null, + "activities": [] + }, + isStagedForDeletion: false } ``` diff --git a/api-reference/v1.0/api/schedule-post-timesoff.md b/api-reference/v1.0/api/schedule-post-timesoff.md index 52543801cf7..52f5ff018d6 100644 --- a/api-reference/v1.0/api/schedule-post-timesoff.md +++ b/api-reference/v1.0/api/schedule-post-timesoff.md @@ -72,15 +72,15 @@ POST https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/timesOff Content-type: application/json { - "@odata.type": "#microsoft.graph.timeOff", - "sharedTimeOff": { - "@odata.type": "microsoft.graph.timeOffItem" - }, - "draftTimeOff": { - "@odata.type": "microsoft.graph.timeOffItem" - }, - "userId": "String", - "isStagedForDeletion": "Boolean" + "userId": "aa162a04-bec6-4b81-ba99-96caa7b2b24d", + "sharedTimeOff": { + "timeOffReasonId": "TOR_29a5ba96-c7ef-4e76-bec6-055323746314", + "startDateTime": "2024-10-10T19:00:00Z", + "endDateTime": "2024-10-10T20:00:00Z", + "theme": "blue" + }, + "draftTimeOff": null, + isStagedForDeletion: false } ``` @@ -134,21 +134,30 @@ HTTP/1.1 201 Created Content-type: application/json { - "@odata.type": "#microsoft.graph.timeOff", - "id": "d8aa6cc9-7a1a-fb34-ed9c-e1ac3dcd54c8", - "createdDateTime": "String (timestamp)", - "lastModifiedDateTime": "String (timestamp)", - "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" - }, - "sharedTimeOff": { - "@odata.type": "microsoft.graph.timeOffItem" - }, - "draftTimeOff": { - "@odata.type": "microsoft.graph.timeOffItem" - }, - "userId": "String", - "isStagedForDeletion": "Boolean" + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('48ba9e52-8d25-41c7-bbe7-5ee6346eec0d')/schedule/timesOff/$entity", + "@odata.etag": "\"40021ee2-0000-0c00-0000-672ea2790000\"", + "id": "SHFT_d0941bce-2229-43f5-b1cd-c9e2eaf592cf", + "createdDateTime": "2024-11-08T23:44:56.913Z", + "lastModifiedDateTime": "2024-11-08T23:44:56.913Z", + "userId": "aa162a04-bec6-4b81-ba99-96caa7b2b24d", + "draftTimeOff": null, + "lastModifiedBy": { + "application": null, + "device": null, + "user": { + "id": "aa162a04-bec6-4b81-ba99-96caa7b2b24d", + "displayName": "victorcheng", + "userIdentityType": "aadUser", + "tenantId": null + } + }, + "sharedTimeOff": { + "timeOffReasonId": "TOR_29a5ba96-c7ef-4e76-bec6-055323746314", + "startDateTime": "2024-10-10T19:00:00Z", + "endDateTime": "2024-10-10T20:00:00Z", + "theme": "blue" + }, + isStagedForDeletion: false } ``` diff --git a/api-reference/v1.0/api/shift-put.md b/api-reference/v1.0/api/shift-put.md index afeb95d0073..04819351109 100644 --- a/api-reference/v1.0/api/shift-put.md +++ b/api-reference/v1.0/api/shift-put.md @@ -70,16 +70,17 @@ PUT https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/shifts/{shiftId} Content-type: application/json { - "@odata.type": "#microsoft.graph.shift", - "sharedShift": { - "@odata.type": "microsoft.graph.shiftItem" - }, - "draftShift": { - "@odata.type": "microsoft.graph.shiftItem" - }, - "userId": "String", - "schedulingGroupId": "String", - "isStagedForDeletion": "Boolean" + "userId": "5ca83ce7-291d-43b7-bf53-af79eef4bc1d", + "draftShift": { + "displayName": null, + "startDateTime": "2024-10-08T15:00:00Z", + "endDateTime": "2024-10-09T00:00:00Z", + "theme": "blue", + "notes": null, + "activities": [] + }, + "sharedShift": null, + "isStagedForDeletion": false } ``` diff --git a/api-reference/v1.0/api/timeoff-put.md b/api-reference/v1.0/api/timeoff-put.md index faf4193f20f..664dfb4bb80 100644 --- a/api-reference/v1.0/api/timeoff-put.md +++ b/api-reference/v1.0/api/timeoff-put.md @@ -74,15 +74,14 @@ Content-type: application/json Prefer: return=representation { - "@odata.type": "#microsoft.graph.timeOff", - "sharedTimeOff": { - "@odata.type": "microsoft.graph.timeOffItem" - }, - "draftTimeOff": { - "@odata.type": "microsoft.graph.timeOffItem" - }, - "userId": "String", - "isStagedForDeletion": "Boolean" + "userId": "aa162a04-bec6-4b81-ba99-96caa7b2b24d", + "sharedTimeOff": { + "timeOffReasonId": "TOR_29a5ba96-c7ef-4e76-bec6-055323746314", + "startDateTime": "2024-10-10T19:00:00Z", + "endDateTime": "2024-10-10T20:00:00Z", + "theme": "blue" + }, + "draftTimeOff": null } ``` diff --git a/api-reference/v1.0/api/workforceintegration-post.md b/api-reference/v1.0/api/workforceintegration-post.md index 1e701458e65..fd426ef072c 100644 --- a/api-reference/v1.0/api/workforceintegration-post.md +++ b/api-reference/v1.0/api/workforceintegration-post.md @@ -77,16 +77,16 @@ POST https://graph.microsoft.com/v1.0/teamwork/workforceIntegrations Content-Type: application/json { - "displayName": "String", - "apiVersion": "Integer", + "displayName": "ABCWorkforceIntegration", + "apiVersion": 1, + "isActive": true, "encryption": { - "protocol": "protocol-value", - "secret": "secret-value" + "protocol": "sharedSecret", + "secret": "My Secret" }, - "isActive": "Boolean", - "url": "String", - "supportedEntities": "String", - "eligibilityFilteringEnabledEntities": "String" + "url": "https://ABCWorkforceIntegration.com/Contoso/", + "supportedEntities": "Shift,SwapRequest", + "eligibilityFilteringEnabledEntities": "SwapRequest" } ``` @@ -141,23 +141,20 @@ HTTP/1.1 201 Created Content-Type: application/json { - "@odata.type": "#microsoft.graph.workforceIntegration", - "id": "b1871d36-f682-351b-9754-79b5e55bd345", - "createdDateTime": "String (timestamp)", - "lastModifiedDateTime": "String (timestamp)", - "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" - }, - "displayName": "String", - "apiVersion": "Integer", + "id": "c5d0c76b-80c4-481c-be50-923cd8d680a1", + "displayName": "ABCWorkforceIntegration", + "apiVersion": 1, + "isActive": true, "encryption": { - "@odata.type": "microsoft.graph.workforceIntegrationEncryption" + "protocol": "sharedSecret", + "secret": null }, - "isActive": "Boolean", - "url": "String", - "supportedEntities": "String", - "eligibilityFilteringEnabledEntities": "String" + "url": "https://abcWorkforceIntegration.com/Contoso/", + "supportedEntities": "Shift,SwapRequest", + "eligibilityFilteringEnabledEntities": "SwapRequest" } + + ``` ## Examples for Use cases of WorkforceIntegration entity for Filtering by WFM rules eligibility @@ -169,6 +166,9 @@ Content-Type: application/json The following example shows a request. ``` POST https://graph.microsoft.com/v1.0/teamwork/workforceIntegrations/ +Authorization: Bearer {token} +Content-type: application/json + { "displayName": "ABCWorkforceIntegration", "apiVersion": 1, @@ -178,11 +178,9 @@ POST https://graph.microsoft.com/v1.0/teamwork/workforceIntegrations/ "secret": "My Secret" }, "url": "https://ABCWorkforceIntegration.com/Contoso/", - "supports": "Shift,SwapRequest", + "supportedEntities": "Shift,SwapRequest", "eligibilityFilteringEnabledEntities": "SwapRequest" } -Authorization: Bearer {token} -Content-type: application/json ``` ### Response @@ -199,7 +197,7 @@ HTTP/1.1 200 OK "secret": null }, "url": "https://abcWorkforceIntegration.com/Contoso/", - "supports": "Shift,SwapRequest", + "supportedEntities": "Shift,SwapRequest", "eligibilityFilteringEnabledEntities": "SwapRequest" } diff --git a/api-reference/v1.0/api/workforceintegration-update.md b/api-reference/v1.0/api/workforceintegration-update.md index 4d34c85b585..6d08e57d3da 100644 --- a/api-reference/v1.0/api/workforceintegration-update.md +++ b/api-reference/v1.0/api/workforceintegration-update.md @@ -75,16 +75,16 @@ PATCH https://graph.microsoft.com/v1.0/teamwork/workforceIntegrations/{workforce Content-Type: application/json { - "displayName": "String", - "apiVersion": "Integer", + "displayName": "ABCWorkforceIntegration", + "apiVersion": 1, + "isActive": true, "encryption": { - "protocol": "protocol-value", - "secret": "secret-value" + "protocol": "sharedSecret", + "secret": "My Secret" }, - "isActive": "Boolean", - "url": "String", - "supportedEntities": "String", - "eligibilityFilteringEnabledEntities": "String" + "url": "https://ABCWorkforceIntegration.com/Contoso/", + "supportedEntities": "Shift,SwapRequest", + "eligibilityFilteringEnabledEntities": "SwapRequest" } ``` @@ -136,25 +136,18 @@ The following example shows the response. ```http HTTP/1.1 200 OK -Content-Type: application/json - { - "@odata.type": "#microsoft.graph.workforceIntegration", - "id": "b1871d36-f682-351b-9754-79b5e55bd345", - "createdDateTime": "String (timestamp)", - "lastModifiedDateTime": "String (timestamp)", - "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" - }, - "displayName": "String", - "apiVersion": "Integer", + "id": "c5d0c76b-80c4-481c-be50-923cd8d680a1", + "displayName": "ABCWorkforceIntegration", + "apiVersion": 1, + "isActive": true, "encryption": { - "@odata.type": "microsoft.graph.workforceIntegrationEncryption" + "protocol": "sharedSecret", + "secret": null }, - "isActive": "Boolean", - "url": "String", - "supportedEntities": "String", - "eligibilityFilteringEnabledEntities": "String" + "url": "https://abcWorkforceIntegration.com/Contoso/", + "supportedEntities": "Shift,SwapRequest", + "eligibilityFilteringEnabledEntities": "SwapRequest" } ``` From 59d227812217764c8c2bec3fc7fc0aca32eeeb70 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:06:58 +0530 Subject: [PATCH 004/144] Update backuprestoreroot-list-restoresessions.md --- .../backuprestoreroot-list-restoresessions.md | 28 +++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/api-reference/beta/api/backuprestoreroot-list-restoresessions.md b/api-reference/beta/api/backuprestoreroot-list-restoresessions.md index c83b3897f86..c69d067a102 100644 --- a/api-reference/beta/api/backuprestoreroot-list-restoresessions.md +++ b/api-reference/beta/api/backuprestoreroot-list-restoresessions.md @@ -120,6 +120,13 @@ Content-Type: application/json "@odata.type": "#microsoft.graph.sharepointRestoreSession", "id": "959ba739-70b5-43c4-8c90-b2c22014f18b", "status": "active", + "restoreJobType": "standard", + "restoreSessionArtifactCount": { + "total": 2, + "completed": 1, + "inProgress": 1, + "failed": 0 + }, "createdBy": { "application": { "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264", @@ -148,6 +155,13 @@ Content-Type: application/json "@odata.type": "#microsoft.graph.exchangeRestoreSession", "id": "959ba739-70b5-43c4-8c90-b2c22014f18b", "status": "active", + "restoreJobType": "standard", + "restoreSessionArtifactCount": { + "total": 2, + "completed": 1, + "inProgress": 1, + "failed": 0 + }, "createdBy": { "application": { "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264", @@ -176,6 +190,13 @@ Content-Type: application/json "@odata.type": "#microsoft.graph.oneDriveForBusinessRestoreSession", "id": "959ba739-70b5-43c4-8c90-b2c22014f18b", "status": "active", + "restoreJobType": "standard", + "restoreSessionArtifactCount": { + "total": 2, + "completed": 1, + "inProgress": 1, + "failed": 0 + }, "createdBy": { "application": { "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264", @@ -204,6 +225,13 @@ Content-Type: application/json "@odata.type": "#microsoft.graph.sharepointRestoreSession", "id": "c86a1eaf-1925-46cc-8ab2-567302dd78a9", "status": "failed", // Newly Added + "restoreJobType": "standard", + "restoreSessionArtifactCount": { + "total": 2, + "completed": 0, + "inProgress": 0, + "failed": 2 + }, "createdBy": { "application": { "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264", From ef3d70607a816093e01842de4b881c77c3e91183 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:11:43 +0530 Subject: [PATCH 005/144] Update backuprestoreroot-post-exchangerestoresessions.md --- ...ckuprestoreroot-post-exchangerestoresessions.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/api-reference/beta/api/backuprestoreroot-post-exchangerestoresessions.md b/api-reference/beta/api/backuprestoreroot-post-exchangerestoresessions.md index 0d5e35e6247..6e882ef2ac5 100644 --- a/api-reference/beta/api/backuprestoreroot-post-exchangerestoresessions.md +++ b/api-reference/beta/api/backuprestoreroot-post-exchangerestoresessions.md @@ -145,6 +145,13 @@ Content-Type: application/json "@odata.context": "/solutions/backupRestore/$metadata#exchangeRestoreSessions/$entity", "id": "959ba739-70b5-43c4-8c90-b2c22014f18b", "status": "draft", + "restoreJobType": "standard", + "restoreSessionArtifactCount": { + "total": 2, + "completed": 0, + "inProgress": 0, + "failed": 0 + }, "createdBy": { "application": { "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264", @@ -251,6 +258,13 @@ Content-Type: application/json "@odata.context": "/solutions/backupRestore/$metadata#exchangeRestoreSessions/$entity", "id": "959ba739-70b5-43c4-8c90-b2c22014f18b", "status": "draft", + "restoreJobType": "standard", + "restoreSessionArtifactCount": { + "total": 2, + "completed": 0, + "inProgress": 0, + "failed": 0 + }, "createdBy": { "application": { "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264", From 140fdd39eccab1b4f717e12fa0a2f605aae240ed Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:12:53 +0530 Subject: [PATCH 006/144] Update backuprestoreroot-post-onedriveforbusinessrestoresessions.md --- ...prestoreroot-post-onedriveforbusinessrestoresessions.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md b/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md index c80a1f74947..73f3a832882 100644 --- a/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md +++ b/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md @@ -142,6 +142,13 @@ Content-Type: application/json "@odata.context": "/solutions/backupRestore/$metadata#oneDriveForBusinessRestoreSession/$entity", "id": "959ba739-70b5-43c4-8c90-b2c22014f18b", "status": "draft", + "restoreJobType": "standard", + "restoreSessionArtifactCount": { + "total": 2, + "completed": 0, + "inProgress": 0, + "failed": 0 + }, "createdBy": { "application": { "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264", From 69b82bb92ff303372bea83fc796723717bdea2e6 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:15:19 +0530 Subject: [PATCH 007/144] Update backuprestoreroot-post-sharepointrestoresessions.md --- .../backuprestoreroot-post-sharepointrestoresessions.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/api-reference/beta/api/backuprestoreroot-post-sharepointrestoresessions.md b/api-reference/beta/api/backuprestoreroot-post-sharepointrestoresessions.md index 167364e8a9f..aff388fbd2f 100644 --- a/api-reference/beta/api/backuprestoreroot-post-sharepointrestoresessions.md +++ b/api-reference/beta/api/backuprestoreroot-post-sharepointrestoresessions.md @@ -142,6 +142,13 @@ Content-Type: application/json "@odata.type": "#microsoft.graph.sharepointRestoreSession", "id": "61633878-8321-4950-bfaf-ed285bdd1461", "status": "activating", + "restoreJobType": "standard", + "restoreSessionArtifactCount": { + "total": 2, + "completed": 0, + "inProgress": 2, + "failed": 0 + }, "createdBy": { "application": { "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264", From 497a6cc0ca704b2e0f981f840098fcf261c140fb Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:17:13 +0530 Subject: [PATCH 008/144] Update exchangerestoresession-list-mailboxrestoreartifacts.md --- .../api/exchangerestoresession-list-mailboxrestoreartifacts.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/api-reference/beta/api/exchangerestoresession-list-mailboxrestoreartifacts.md b/api-reference/beta/api/exchangerestoresession-list-mailboxrestoreartifacts.md index 2ebc7f626e4..1fb0b114235 100644 --- a/api-reference/beta/api/exchangerestoresession-list-mailboxrestoreartifacts.md +++ b/api-reference/beta/api/exchangerestoresession-list-mailboxrestoreartifacts.md @@ -125,6 +125,7 @@ Content-Type: application/json "completionDateTime": "2023-12-04T13:22:12.7209691Z", "restoredFolderId": "0bdb38aa-5ad4-43ae-b63d-54426c97caa3", "restoredFolderName": "testmailbox101", + "restoredItemCount": 5, "restorePoint": { "id": "ffd2687a-f507-4a82-9dff-2fa78cfdaa41_1801645000_12_2", "protectionDateTime": "2023-12-04T00:00:00Z", @@ -139,6 +140,7 @@ Content-Type: application/json "completionDateTime": "2024-02-10T13:22:12.7209691Z", "restoredFolderId": "f8bb7c43-dabd-4300-a56a-510f093bc537", "restoredFolderName": "testmailbox102", + "restoredItemCount": 10, "restorePoint": { "id": "86ba0fa7-db56-4c70-bf47-62adafefc0ee_1801645000_12_2", "protectionDateTime": "2024-02-10T00:00:00Z", From a40434cbf79e723bdd4d66703604274e34fb9291 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:18:15 +0530 Subject: [PATCH 009/144] Update restoresessionbase-get.md --- api-reference/beta/api/restoresessionbase-get.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/api-reference/beta/api/restoresessionbase-get.md b/api-reference/beta/api/restoresessionbase-get.md index a839770d6e7..617ee1a0cfd 100644 --- a/api-reference/beta/api/restoresessionbase-get.md +++ b/api-reference/beta/api/restoresessionbase-get.md @@ -118,6 +118,13 @@ Content-Type: application/json "@odata.type": "#microsoft.graph.sharepointRestoreSession", "id": "959ba739-70b5-43c4-8c90-b2c22014f18b", "status": "active", + "restoreJobType": "standard", + "restoreSessionArtifactCount": { + "total": 2, + "completed": 1, + "inProgress": 1, + "failed": 0 + }, "createdBy": { "application": { "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264", From 5fd72684d1c05443eddee648ddb0975a3c0e7042 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:19:24 +0530 Subject: [PATCH 010/144] Update restoresessionbase-activate.md --- api-reference/beta/api/restoresessionbase-activate.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/api-reference/beta/api/restoresessionbase-activate.md b/api-reference/beta/api/restoresessionbase-activate.md index 687c8a4a0ab..1b8b3951bab 100644 --- a/api-reference/beta/api/restoresessionbase-activate.md +++ b/api-reference/beta/api/restoresessionbase-activate.md @@ -133,6 +133,13 @@ Content-Type: application/json "@odata.type": "#microsoft.graph.sharepointRestoreSession", "id": "61633878-8321-4950-bfaf-ed285bdd1461", "status": "activating", + "restoreJobType": "standard", + "restoreSessionArtifactCount": { + "total": 2, + "completed": 0, + "inProgress": 2, + "failed": 0 + }, "createdBy": { "application": { "id": "1fec8e78-bce4-4aaf-ab1b-5451cc387264", From ee2fbf13fc34c940cf94ac8b1bf7439bb262af33 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:23:30 +0530 Subject: [PATCH 011/144] Update enums.md --- api-reference/beta/resources/enums.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/api-reference/beta/resources/enums.md b/api-reference/beta/resources/enums.md index 335d9326e45..58164989c69 100644 --- a/api-reference/beta/resources/enums.md +++ b/api-reference/beta/resources/enums.md @@ -4917,3 +4917,11 @@ Possible values for user account types (group membership), per Windows definitio |false| |true| |unknownFutureValue| + +### restoreJobType values + +|Member| +|:---| +|standard| +|bulk| +|unknownFutureValue| From c2b254525a744968a163a6fdfc21ee50fe139b5f Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:31:40 +0530 Subject: [PATCH 012/144] Update exchangerestoresession.md --- api-reference/beta/resources/exchangerestoresession.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/api-reference/beta/resources/exchangerestoresession.md b/api-reference/beta/resources/exchangerestoresession.md index 89dba1bb360..13ecb9f5d02 100644 --- a/api-reference/beta/resources/exchangerestoresession.md +++ b/api-reference/beta/resources/exchangerestoresession.md @@ -36,6 +36,8 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |lastModifiedBy|[identitySet](../resources/identityset.md)|Identity of the person who last modified this restore session.| |lastModifiedDateTime|DateTimeOffset|Timestamp of last modification of this restore session.| |status|[restoreSessionStatus](../resources/exchangerestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| +|restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Type of the restore session, whether it is created normally or via bulk job.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoreSessionBase.md#restoreSessionArtifactCount)|Count metadata of the artifacts belonging to this restore session.| ### restoreSessionStatus values |Member | Description | @@ -68,6 +70,10 @@ The following JSON representation shows the resource type. "@odata.type": "#microsoft.graph.exchangeRestoreSession", "id": "String (identifier)", "status": "String", + "restoreJobType": "String", + "restoreSessionArtifactCount": { + "@odata.type": "microsoft.graph.restoreSessionArtifactCount" + }, "createdDateTime": "String (timestamp)", "createdBy": { "@odata.type": "microsoft.graph.identitySet" From 9ee6097df87529deeaffe2fdc44919f95229ae5a Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:32:42 +0530 Subject: [PATCH 013/144] Update onedriveforbusinessrestoresession.md --- .../beta/resources/onedriveforbusinessrestoresession.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/api-reference/beta/resources/onedriveforbusinessrestoresession.md b/api-reference/beta/resources/onedriveforbusinessrestoresession.md index 3bf8ae35e06..1701085f89d 100644 --- a/api-reference/beta/resources/onedriveforbusinessrestoresession.md +++ b/api-reference/beta/resources/onedriveforbusinessrestoresession.md @@ -37,6 +37,8 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |lastModifiedBy|[identitySet](../resources/identityset.md)|Identity of the person who last modified this restore session.| |lastModifiedDateTime|DateTimeOffset|Timestamp of the last modification of this restore session.| |status|[restoreSessionStatus](../resources/onedriveforbusinessrestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| +|restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Type of the restore session, whether it is created normally or via bulk job.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoreSessionBase.md#restoreSessionArtifactCount)|Count metadata of the artifacts belonging to this restore session.| ### restoreSessionStatus values @@ -70,6 +72,10 @@ The following JSON representation shows the resource type. "@odata.type": "#microsoft.graph.oneDriveForBusinessRestoreSession", "id": "String (identifier)", "status": "String", + "restoreJobType": "String", + "restoreSessionArtifactCount": { + "@odata.type": "microsoft.graph.restoreSessionArtifactCount" + }, "createdDateTime": "String (timestamp)", "createdBy": { "@odata.type": "microsoft.graph.identitySet" From 68034b042ee9d134cd0f37f423912a2576467934 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:33:44 +0530 Subject: [PATCH 014/144] Update sharepointrestoresession.md --- api-reference/beta/resources/sharepointrestoresession.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/api-reference/beta/resources/sharepointrestoresession.md b/api-reference/beta/resources/sharepointrestoresession.md index 819d3c92316..96b9041a8fe 100644 --- a/api-reference/beta/resources/sharepointrestoresession.md +++ b/api-reference/beta/resources/sharepointrestoresession.md @@ -39,6 +39,8 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |lastModifiedBy|[identitySet](../resources/identityset.md)|Identity of the person who last modified this restore session.| |lastModifiedDateTime|DateTimeOffset|Timestamp of last modification of this restore session.| |status|[restoreSessionStatus](../resources/sharepointrestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of restore artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| +|restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Type of the restore session, whether it is created normally or via bulk job.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoreSessionBase.md#restoreSessionArtifactCount)|Count metadata of the artifacts belonging to this restore session.| ### restoreSessionStatus values @@ -74,6 +76,10 @@ The following JSON representation shows the resource type. "@odata.type": "#microsoft.graph.sharePointRestoreSession", "id": "String (identifier)", "status": "String", + "restoreJobType": "String", + "restoreSessionArtifactCount": { + "@odata.type": "microsoft.graph.restoreSessionArtifactCount" + }, "createdDateTime": "String (timestamp)", "createdBy": { "@odata.type": "microsoft.graph.identitySet" From 33040ed62cefa64fa67f179dad8bdbeb16cc4028 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:37:00 +0530 Subject: [PATCH 015/144] Update mailboxrestoreartifact.md --- api-reference/beta/resources/mailboxrestoreartifact.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/api-reference/beta/resources/mailboxrestoreartifact.md b/api-reference/beta/resources/mailboxrestoreartifact.md index dc670a744df..2b9fe694d07 100644 --- a/api-reference/beta/resources/mailboxrestoreartifact.md +++ b/api-reference/beta/resources/mailboxrestoreartifact.md @@ -32,6 +32,7 @@ Inherits from [restoreArtifactBase](../resources/restoreartifactbase.md). |error|[publicError](../resources/publicerror.md)|Contains error details if the restoration of the artifact fails. Inherited from [restoreArtifactBase](../resources/restoreartifactbase.md).| |restoredFolderId|String|The new restored folder identifier for the user.| |restoredFolderName|String|The new restored folder name.| +|restoredItemCount|Int32|Number of items that are being restored in the folder.| |startDateTime|DateTimeOffset|The time when the restoration of the artifact started. Inherited from [restoreArtifactBase](../resources/restoreartifactbase.md).| |status|[artifactRestoreStatus](../resources/mailboxrestoreartifact.md#artifactrestorestatus-values)|The restoration status of the artifact. Inherited from [restoreArtifactBase](../resources/restoreartifactbase.md).T he possible values are: `added`, `scheduling`, `scheduled`, `inProgress`, `succeeded`, `failed`, `unknownFutureValue`.| @@ -82,7 +83,8 @@ The following JSON representation shows the resource type. "@odata.type": "microsoft.graph.publicError" }, "restoredFolderId": "String", - "restoredFolderName": "String" + "restoredFolderName": "String", + "restoredItemCount": "Int32" } ``` From 070ab9f54947135d7f294030f13b03c63d6ab767 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:38:04 +0530 Subject: [PATCH 016/144] Update granularmailboxrestoreartifact.md --- api-reference/beta/resources/granularmailboxrestoreartifact.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/api-reference/beta/resources/granularmailboxrestoreartifact.md b/api-reference/beta/resources/granularmailboxrestoreartifact.md index 08a49454f0e..ac3327b5923 100644 --- a/api-reference/beta/resources/granularmailboxrestoreartifact.md +++ b/api-reference/beta/resources/granularmailboxrestoreartifact.md @@ -33,6 +33,7 @@ Inherits from [mailboxRestoreArtifact](../resources/mailboxRestoreArtifact.md). |error|[publicError](../resources/publicerror.md)|Contains error details if the restoration of the artifact fails. Inherited from [restoreArtifactBase](../resources/restoreartifactbase.md).| |restoredFolderId|String|The new restored folder identifier for the user.| |restoredFolderName|String|The new restored folder name.| +|restoredItemCount|Int32|Number of items that are being restored in the folder.| |searchResponseId|String|.| |startDateTime|DateTimeOffset|The time when the restoration of the artifact started. Inherited from [restoreArtifactBase](../resources/restoreartifactbase.md).| |status|[artifactRestoreStatus](../resources/mailboxrestoreartifact.md#artifactrestorestatus-values)|The restoration status of the artifact. Inherited from [restoreArtifactBase](../resources/restoreartifactbase.md).T he possible values are: `added`, `scheduling`, `scheduled`, `inProgress`, `succeeded`, `failed`, `unknownFutureValue`.| @@ -66,6 +67,7 @@ The following JSON representation shows the resource type. }, "restoredFolderId": "String", "restoredFolderName": "String", + "restoredItemCount": "Int32", "searchResponseId": "String" } ``` From 353252cd74187a8ffb8248e1f10cdb0a4c6062bd Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:44:54 +0530 Subject: [PATCH 017/144] Update restoresessionbase.md --- .../beta/resources/restoresessionbase.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/api-reference/beta/resources/restoresessionbase.md b/api-reference/beta/resources/restoresessionbase.md index 958b44e2b42..f3d1024627b 100644 --- a/api-reference/beta/resources/restoresessionbase.md +++ b/api-reference/beta/resources/restoresessionbase.md @@ -40,6 +40,8 @@ Restoring to both a new location and the same URL in a single restore session is |lastModifiedBy|identitySet|Identity of the person who last modified the restore session.| |lastModifiedDateTime|DateTimeOffset|Timestamp of the last modification of the restore session.| |status|[restoreSessionStatus](../resources/restoresessionbase.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| +|restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Type of the restore session, whether it is created normally or via bulk job.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoreSessionBase.md#restoreSessionArtifactCount)|Count metadata of the artifacts belonging to this restore session.| ### restoreSessionStatus values @@ -53,6 +55,15 @@ Restoring to both a new location and the same URL in a single restore session is |failed| All restore artifacts failed to restore.| |unknownFutureValue| Evolvable enumeration sentinel value. Don't use.| +### restoreSessionArtifactCount + +|Property |Type |Description | +|:------|:-----|:------------| +|total|Int32|Count of artifacts that are added in the restoreSession.| +|completed|Int32|Count of artifacts whose restore is completed.| +|inProgress|Int32|Count of artifacts whose restore is in progress.| +|failed|Int32|Count of artifacts whose restore has failed.| + ## Relationships None. @@ -73,6 +84,10 @@ The following JSON representation shows the resource type. "@odata.type": "#microsoft.graph.restoreSessionBase", "id": "String (identifier)", "status": "String", + "restoreJobType": "String", + "restoreSessionArtifactCount": { + "@odata.type": "microsoft.graph.restoreSessionArtifactCount" + }, "createdDateTime": "String (timestamp)", "createdBy": { "@odata.type": "microsoft.graph.identitySet" From e04613d352c6ba823612e35845ace6945d0fa742 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:45:30 +0530 Subject: [PATCH 018/144] Update restoresessionbase.md --- api-reference/beta/resources/restoresessionbase.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/restoresessionbase.md b/api-reference/beta/resources/restoresessionbase.md index f3d1024627b..297a3110ff7 100644 --- a/api-reference/beta/resources/restoresessionbase.md +++ b/api-reference/beta/resources/restoresessionbase.md @@ -41,7 +41,7 @@ Restoring to both a new location and the same URL in a single restore session is |lastModifiedDateTime|DateTimeOffset|Timestamp of the last modification of the restore session.| |status|[restoreSessionStatus](../resources/restoresessionbase.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| |restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Type of the restore session, whether it is created normally or via bulk job.| -|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoreSessionBase.md#restoreSessionArtifactCount)|Count metadata of the artifacts belonging to this restore session.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoreSessionArtifactCount)|Count metadata of the artifacts belonging to this restore session.| ### restoreSessionStatus values From 15826ac17639defd6a640d8c434612c41f241705 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:45:59 +0530 Subject: [PATCH 019/144] Update exchangerestoresession.md --- api-reference/beta/resources/exchangerestoresession.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/exchangerestoresession.md b/api-reference/beta/resources/exchangerestoresession.md index 13ecb9f5d02..f0fcd1c2f09 100644 --- a/api-reference/beta/resources/exchangerestoresession.md +++ b/api-reference/beta/resources/exchangerestoresession.md @@ -37,7 +37,7 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |lastModifiedDateTime|DateTimeOffset|Timestamp of last modification of this restore session.| |status|[restoreSessionStatus](../resources/exchangerestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| |restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Type of the restore session, whether it is created normally or via bulk job.| -|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoreSessionBase.md#restoreSessionArtifactCount)|Count metadata of the artifacts belonging to this restore session.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoreSessionArtifactCount)|Count metadata of the artifacts belonging to this restore session.| ### restoreSessionStatus values |Member | Description | From 5698b1d48ac08f12c403483343f97754fb9556ce Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:46:27 +0530 Subject: [PATCH 020/144] Update onedriveforbusinessrestoresession.md --- .../beta/resources/onedriveforbusinessrestoresession.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/onedriveforbusinessrestoresession.md b/api-reference/beta/resources/onedriveforbusinessrestoresession.md index 1701085f89d..be22ef9c398 100644 --- a/api-reference/beta/resources/onedriveforbusinessrestoresession.md +++ b/api-reference/beta/resources/onedriveforbusinessrestoresession.md @@ -38,7 +38,7 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |lastModifiedDateTime|DateTimeOffset|Timestamp of the last modification of this restore session.| |status|[restoreSessionStatus](../resources/onedriveforbusinessrestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| |restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Type of the restore session, whether it is created normally or via bulk job.| -|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoreSessionBase.md#restoreSessionArtifactCount)|Count metadata of the artifacts belonging to this restore session.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoreSessionArtifactCount)|Count metadata of the artifacts belonging to this restore session.| ### restoreSessionStatus values From 6bca9ffda7d1b276a21bb4232e3c17c08a7dcd11 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 18:46:56 +0530 Subject: [PATCH 021/144] Update sharepointrestoresession.md --- api-reference/beta/resources/sharepointrestoresession.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/sharepointrestoresession.md b/api-reference/beta/resources/sharepointrestoresession.md index 96b9041a8fe..f620029cf9b 100644 --- a/api-reference/beta/resources/sharepointrestoresession.md +++ b/api-reference/beta/resources/sharepointrestoresession.md @@ -40,7 +40,7 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |lastModifiedDateTime|DateTimeOffset|Timestamp of last modification of this restore session.| |status|[restoreSessionStatus](../resources/sharepointrestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of restore artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| |restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Type of the restore session, whether it is created normally or via bulk job.| -|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoreSessionBase.md#restoreSessionArtifactCount)|Count metadata of the artifacts belonging to this restore session.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoreSessionArtifactCount)|Count metadata of the artifacts belonging to this restore session.| ### restoreSessionStatus values From 8fcd9846769b0bc0c177a53893aea7a5eeec5224 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 19:01:20 +0530 Subject: [PATCH 022/144] Update Microsoft.EnhancedRestore.json --- changelog/Microsoft.EnhancedRestore.json | 50 ++++++++++++++++++++++++ 1 file changed, 50 insertions(+) diff --git a/changelog/Microsoft.EnhancedRestore.json b/changelog/Microsoft.EnhancedRestore.json index 200677fed0a..623aff70a24 100644 --- a/changelog/Microsoft.EnhancedRestore.json +++ b/changelog/Microsoft.EnhancedRestore.json @@ -1,5 +1,55 @@ { "changelog": [ + { + "ChangeList": [ + { + "Id": "3d1ebd63-cc2f-4596-b0f1-60bd22b96b46", + "ApiChange": "Enumeration", + "ChangedApiName": "restoreJobType", + "ChangeType": "Addition", + "Description": "Added the **restoreJobType** enumeration type.", + "Target": "restoreJobType" + }, + { + "Id": "3d1ebd63-cc2f-4596-b0f1-60bd22b96b46", + "ApiChange": "Resource", + "ChangedApiName": "restoreSessionArtifactCount", + "ChangeType": "Addition", + "Description": "Added the **restoreSessionArtifactCount** resource.", + "Target": "restoreSessionArtifactCount" + }, + { + "Id": "3d1ebd63-cc2f-4596-b0f1-60bd22b96b46", + "ApiChange": "Property", + "ChangedApiName": "restoredItemCount", + "ChangeType": "Addition", + "Description": "Added the **restoredItemCount** property to the [mailboxRestoreArtifact](https://learn.microsoft.com/en-us/graph/api/resources/mailboxRestoreArtifact?view=graph-rest-beta) resource.", + "Target": "mailboxRestoreArtifact" + }, + { + "Id": "3d1ebd63-cc2f-4596-b0f1-60bd22b96b46", + "ApiChange": "Property", + "ChangedApiName": "restoreJobType", + "ChangeType": "Addition", + "Description": "Added the **restoreJobType** property to the [restoreSessionBase](https://learn.microsoft.com/en-us/graph/api/resources/restoreSessionBase?view=graph-rest-beta) resource.", + "Target": "restoreSessionBase" + }, + { + "Id": "3d1ebd63-cc2f-4596-b0f1-60bd22b96b46", + "ApiChange": "Property", + "ChangedApiName": "restoreSessionArtifactCount", + "ChangeType": "Addition", + "Description": "Added the **restoreSessionArtifactCount** property to the [restoreSessionBase](https://learn.microsoft.com/en-us/graph/api/resources/restoreSessionBase?view=graph-rest-beta) resource.", + "Target": "restoreSessionBase" + } + ], + "Id": "3d1ebd63-cc2f-4596-b0f1-60bd22b96b46", + "Cloud": "Prod", + "Version": "beta", + "CreatedDateTime": "2024-10-25T07:34:17.3898972Z", + "WorkloadArea": "EnhancedRestore", + "SubArea": "Backup and Restore" + }, { "ChangeList": [ { From eae559a6d179099e0602e52bc5123525ae182ae1 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Sun, 10 Nov 2024 19:04:34 +0530 Subject: [PATCH 023/144] Delete api-reference/beta/api/exchangerestoresession-get.md --- .../beta/api/exchangerestoresession-get.md | 110 ------------------ 1 file changed, 110 deletions(-) delete mode 100644 api-reference/beta/api/exchangerestoresession-get.md diff --git a/api-reference/beta/api/exchangerestoresession-get.md b/api-reference/beta/api/exchangerestoresession-get.md deleted file mode 100644 index 75505af024a..00000000000 --- a/api-reference/beta/api/exchangerestoresession-get.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: "Get exchangeRestoreSession" -description: "Read the properties and relationships of an exchangeRestoreSession object." -author: "**TODO: Provide GitHub Name. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" -ms.localizationpriority: medium -ms.subservice: "**TODO: Add MS subservice. See [topic-level metadata reference](https://aka.ms/msgo?pagePath=Document-APIs/Guidelines/Metadata)**" -doc_type: apiPageType ---- - -# Get exchangeRestoreSession - -Namespace: microsoft.graph - -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - -Read the properties and relationships of an [exchangeRestoreSession](../resources/exchangerestoresession.md) object. - -## 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](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). - - -[!INCLUDE [permissions-table](../includes/permissions/exchangerestoresession-get-permissions.md)] - -## HTTP request - - -``` http -GET /solutions/backupRestore/exchangeRestoreSessions/{exchangeRestoreSessionId} -``` - -## Optional query parameters - -This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). - -## Request headers - -|Name|Description| -|:---|:---| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| - -## Request body - -Don't supply a request body for this method. - -## Response - -If successful, this method returns a `200 OK` response code and an [exchangeRestoreSession](../resources/exchangerestoresession.md) object in the response body. - -## Examples - -### Request - -The following example shows a request. - -``` http -GET https://graph.microsoft.com/beta/solutions/backupRestore/exchangeRestoreSessions/{exchangeRestoreSessionId} -``` - - -### Response - -The following example shows the response. ->**Note:** The response object shown here might be shortened for readability. - -``` http -HTTP/1.1 200 OK -Content-Type: application/json - -{ - "value": { - "@odata.type": "#microsoft.graph.exchangeRestoreSession", - "id": "805176da-2882-e843-fe2f-4d260d92e2a1", - "status": "String", - "restoreJobType": "String", - "createdDateTime": "String (timestamp)", - "createdBy": { - "@odata.type": "microsoft.graph.identitySet" - }, - "completedDateTime": "String (timestamp)", - "restoreSessionArtifactCount": { - "@odata.type": "microsoft.graph.restoreSessionArtifactCount" - }, - "lastModifiedDateTime": "String (timestamp)", - "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" - }, - "error": { - "@odata.type": "microsoft.graph.publicError" - } - } -} -``` - From 93d2d054f21221174684f7fe4896ca83dd0f0c63 Mon Sep 17 00:00:00 2001 From: mnorman-ms Date: Mon, 11 Nov 2024 15:48:33 +0700 Subject: [PATCH 024/144] Wording and stylistic changes. --- .../beta/resources/exchangerestoresession.md | 4 ++-- .../resources/onedriveforbusinessrestoresession.md | 4 ++-- api-reference/beta/resources/restoresessionbase.md | 12 ++++++------ .../beta/resources/sharepointrestoresession.md | 4 ++-- 4 files changed, 12 insertions(+), 12 deletions(-) diff --git a/api-reference/beta/resources/exchangerestoresession.md b/api-reference/beta/resources/exchangerestoresession.md index f0fcd1c2f09..27f20674094 100644 --- a/api-reference/beta/resources/exchangerestoresession.md +++ b/api-reference/beta/resources/exchangerestoresession.md @@ -36,8 +36,8 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |lastModifiedBy|[identitySet](../resources/identityset.md)|Identity of the person who last modified this restore session.| |lastModifiedDateTime|DateTimeOffset|Timestamp of last modification of this restore session.| |status|[restoreSessionStatus](../resources/exchangerestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| -|restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Type of the restore session, whether it is created normally or via bulk job.| -|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoreSessionArtifactCount)|Count metadata of the artifacts belonging to this restore session.| +|restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Indicates whether the restore sesssion was created normally or by a bulk job.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoreSessionArtifactCount)|The number of metadata artifacts that belong to this restore session.| ### restoreSessionStatus values |Member | Description | diff --git a/api-reference/beta/resources/onedriveforbusinessrestoresession.md b/api-reference/beta/resources/onedriveforbusinessrestoresession.md index be22ef9c398..a0cf525c1c2 100644 --- a/api-reference/beta/resources/onedriveforbusinessrestoresession.md +++ b/api-reference/beta/resources/onedriveforbusinessrestoresession.md @@ -37,8 +37,8 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |lastModifiedBy|[identitySet](../resources/identityset.md)|Identity of the person who last modified this restore session.| |lastModifiedDateTime|DateTimeOffset|Timestamp of the last modification of this restore session.| |status|[restoreSessionStatus](../resources/onedriveforbusinessrestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| -|restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Type of the restore session, whether it is created normally or via bulk job.| -|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoreSessionArtifactCount)|Count metadata of the artifacts belonging to this restore session.| +|restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Indicates whether the restore sesssion was created normally or by a bulk job.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoreSessionArtifactCount)|The number of metadata artifacts that belong to this restore session.| ### restoreSessionStatus values diff --git a/api-reference/beta/resources/restoresessionbase.md b/api-reference/beta/resources/restoresessionbase.md index 297a3110ff7..45f856e447d 100644 --- a/api-reference/beta/resources/restoresessionbase.md +++ b/api-reference/beta/resources/restoresessionbase.md @@ -40,8 +40,8 @@ Restoring to both a new location and the same URL in a single restore session is |lastModifiedBy|identitySet|Identity of the person who last modified the restore session.| |lastModifiedDateTime|DateTimeOffset|Timestamp of the last modification of the restore session.| |status|[restoreSessionStatus](../resources/restoresessionbase.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| -|restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Type of the restore session, whether it is created normally or via bulk job.| -|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoreSessionArtifactCount)|Count metadata of the artifacts belonging to this restore session.| +|restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Indicates whether the restore sesssion was created normally or by a bulk job.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoreSessionArtifactCount)|The number of metadata artifacts that belong to this restore session.| ### restoreSessionStatus values @@ -59,10 +59,10 @@ Restoring to both a new location and the same URL in a single restore session is |Property |Type |Description | |:------|:-----|:------------| -|total|Int32|Count of artifacts that are added in the restoreSession.| -|completed|Int32|Count of artifacts whose restore is completed.| -|inProgress|Int32|Count of artifacts whose restore is in progress.| -|failed|Int32|Count of artifacts whose restore has failed.| +|total|Int32|The number of artifacts added in the restore session.| +|completed|Int32|The number of artifacts whose restore is complete.| +|inProgress|Int32|The number of artifacts whose restore is in progress.| +|failed|Int32|The number of artifacts whose restore failed.| ## Relationships diff --git a/api-reference/beta/resources/sharepointrestoresession.md b/api-reference/beta/resources/sharepointrestoresession.md index f620029cf9b..163aa71f81c 100644 --- a/api-reference/beta/resources/sharepointrestoresession.md +++ b/api-reference/beta/resources/sharepointrestoresession.md @@ -39,8 +39,8 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |lastModifiedBy|[identitySet](../resources/identityset.md)|Identity of the person who last modified this restore session.| |lastModifiedDateTime|DateTimeOffset|Timestamp of last modification of this restore session.| |status|[restoreSessionStatus](../resources/sharepointrestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of restore artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| -|restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Type of the restore session, whether it is created normally or via bulk job.| -|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoreSessionArtifactCount)|Count metadata of the artifacts belonging to this restore session.| +|restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Indicates whether the restore sesssion was created normally or by a bulk job.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoreSessionArtifactCount)|The number of metadata artifacts that belong to this restore session.| ### restoreSessionStatus values From bf890809bb3765207057a78e93ff1b3866284b8a Mon Sep 17 00:00:00 2001 From: mnorman-ms Date: Mon, 11 Nov 2024 16:28:22 +0700 Subject: [PATCH 025/144] Raised Acrolinx score for mailboxrestoreartifact.md --- api-reference/beta/resources/mailboxrestoreartifact.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/api-reference/beta/resources/mailboxrestoreartifact.md b/api-reference/beta/resources/mailboxrestoreartifact.md index 2b9fe694d07..e8d8dd26e37 100644 --- a/api-reference/beta/resources/mailboxrestoreartifact.md +++ b/api-reference/beta/resources/mailboxrestoreartifact.md @@ -34,7 +34,7 @@ Inherits from [restoreArtifactBase](../resources/restoreartifactbase.md). |restoredFolderName|String|The new restored folder name.| |restoredItemCount|Int32|Number of items that are being restored in the folder.| |startDateTime|DateTimeOffset|The time when the restoration of the artifact started. Inherited from [restoreArtifactBase](../resources/restoreartifactbase.md).| -|status|[artifactRestoreStatus](../resources/mailboxrestoreartifact.md#artifactrestorestatus-values)|The restoration status of the artifact. Inherited from [restoreArtifactBase](../resources/restoreartifactbase.md).T he possible values are: `added`, `scheduling`, `scheduled`, `inProgress`, `succeeded`, `failed`, `unknownFutureValue`.| +|status|[artifactRestoreStatus](../resources/mailboxrestoreartifact.md#artifactrestorestatus-values)|The restoration status of the artifact. Inherited from [restoreArtifactBase](../resources/restoreartifactbase.md). The possible values are: `added`, `scheduling`, `scheduled`, `inProgress`, `succeeded`, `failed`, `unknownFutureValue`.| ### artifactRestoreStatus values @@ -46,15 +46,15 @@ Inherits from [restoreArtifactBase](../resources/restoreartifactbase.md). |inProgress|The restore artifact was picked for restoration.| |succeeded|The restore artifact was successfully restored.| |failed|The restoration of the artifact failed.| -|unknownFutureValue| Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue| Evolvable enumeration sentinel value. Don't use.| ### destinationType values |Member | Description | |:------|:------------| -|new|Restoration will occur at a new location. For SharePoint and OneDrive, a new site will be created and content will be restored in the new site. For Exchange, a restored folder is created and content will be restored there.| -|inPlace|Restoration will occur in the same location. For SharePoint, it will be on the same site, for OneDrive, on the same drive, and for Exchange, the artifact will be restored in the same mailbox.| -|unknownFutureValue|Evolvable enumeration sentinel value. Do not use.| +|new|Restoration occurs at a new location. For SharePoint and OneDrive, a new site is created and content is restored in the new site. For Exchange, a restored folder is created and content is restored there.| +|inPlace|Restoration occurs in the same location. For SharePoint, it is on the same site, for OneDrive, on the same drive, and for Exchange, the artifact is restored in the same mailbox.| +|unknownFutureValue|Evolvable enumeration sentinel value. Don't use.| ## Relationships |Relationship|Type|Description| From d9a44fcd03141b0091f880d6c7d34d71aab37364 Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Tue, 12 Nov 2024 11:04:54 -0800 Subject: [PATCH 026/144] fix link error --- api-reference/v1.0/api/openshift-post.md | 6 +++--- api-reference/v1.0/api/openshift-update.md | 6 +++--- ...shiftstagefordeletion-javascript-snippets.md | 16 ++++++++++++++++ ...shiftstagefordeletion-javascript-snippets.md | 17 +++++++++++++++++ ...meoffstagefordeletion-javascript-snippets.md | 17 +++++++++++++++++ 5 files changed, 56 insertions(+), 6 deletions(-) create mode 100644 api-reference/v1.0/includes/snippets/javascript/openshiftstagefordeletion-javascript-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/javascript/shiftstagefordeletion-javascript-snippets.md create mode 100644 api-reference/v1.0/includes/snippets/javascript/timeoffstagefordeletion-javascript-snippets.md diff --git a/api-reference/v1.0/api/openshift-post.md b/api-reference/v1.0/api/openshift-post.md index 3e0d77f657f..3a76f0ebe7d 100644 --- a/api-reference/v1.0/api/openshift-post.md +++ b/api-reference/v1.0/api/openshift-post.md @@ -46,10 +46,10 @@ Provide the modified [openShift](../resources/openshift.md) object in the reques |Property|Type|Description| |:---|:---|:---| -| draftOpenShift | [openShiftItem](openshiftitem.md) | Draft changes in the **openShift** are only visible to managers until they're [shared](../api/schedule-share.md). Either sharedOpenShift or sharedOpenShift should be null| +| draftOpenShift | [openShiftItem](../resources/openshiftitem.md) | Draft changes in the **openShift** are only visible to managers until they're [shared](../api/schedule-share.md). Either sharedOpenShift or sharedOpenShift should be null| | isStagedForDeletion | Boolean | The **openShift** is marked for deletion, a process that is finalized when the schedule is [shared](../api/schedule-share.md). Optional. | -| schedulingGroupId | String | The ID of the [schedulingGroup](schedulinggroup.md) that contains the **openShift**. | -| sharedOpenShift | [openShiftItem](openshiftitem.md) | The shared version of this **openShift** that is viewable by both employees and managers. Either sharedOpenShift or sharedOpenShift should be null| +| schedulingGroupId | String | The ID of the [schedulingGroup](../resources/schedulinggroup.md) that contains the **openShift**. | +| sharedOpenShift | [openShiftItem](../resources/openshiftitem.md) | The shared version of this **openShift** that is viewable by both employees and managers. Either sharedOpenShift or sharedOpenShift should be null| ## Response diff --git a/api-reference/v1.0/api/openshift-update.md b/api-reference/v1.0/api/openshift-update.md index 85ea8737384..9f540dcf756 100644 --- a/api-reference/v1.0/api/openshift-update.md +++ b/api-reference/v1.0/api/openshift-update.md @@ -44,10 +44,10 @@ Provide the modified [openShift](../resources/openshift.md) object in the reques |Property|Type|Description| |:---|:---|:---| -| draftOpenShift | [openShiftItem](openshiftitem.md) | Draft changes in the **openShift** are only visible to managers until they're [shared](../api/schedule-share.md). Either sharedOpenShift or sharedOpenShift should be null.| +| draftOpenShift | [openShiftItem](../resources/openshiftitem.md) | Draft changes in the **openShift** are only visible to managers until they're [shared](../api/schedule-share.md). Either sharedOpenShift or sharedOpenShift should be null.| | isStagedForDeletion | Boolean | The **openShift** is marked for deletion, a process that is finalized when the schedule is [shared](../api/schedule-share.md). Optional. | -| schedulingGroupId | String | The ID of the [schedulingGroup](schedulinggroup.md) that contains the **openShift**. | -| sharedOpenShift | [openShiftItem](openshiftitem.md) | The shared version of this **openShift** that is viewable by both employees and managers. Either sharedOpenShift or sharedOpenShift should be null.| +| schedulingGroupId | String | The ID of the [schedulingGroup](../resources/schedulinggroup.md) that contains the **openShift**. | +| sharedOpenShift | [openShiftItem](../resources/openshiftitem.md) | The shared version of this **openShift** that is viewable by both employees and managers. Either sharedOpenShift or sharedOpenShift should be null.| ## Response diff --git a/api-reference/v1.0/includes/snippets/javascript/openshiftstagefordeletion-javascript-snippets.md b/api-reference/v1.0/includes/snippets/javascript/openshiftstagefordeletion-javascript-snippets.md new file mode 100644 index 00000000000..97d1571be1c --- /dev/null +++ b/api-reference/v1.0/includes/snippets/javascript/openshiftstagefordeletion-javascript-snippets.md @@ -0,0 +1,16 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```javascript + +const options = { + authProvider, +}; + +const client = Client.init(options); + +await client.api('/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/openShifts/OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion') + .post(); + +``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/javascript/shiftstagefordeletion-javascript-snippets.md b/api-reference/v1.0/includes/snippets/javascript/shiftstagefordeletion-javascript-snippets.md new file mode 100644 index 00000000000..e9017169860 --- /dev/null +++ b/api-reference/v1.0/includes/snippets/javascript/shiftstagefordeletion-javascript-snippets.md @@ -0,0 +1,17 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```javascript + +const options = { + authProvider, +}; + +const client = Client.init(options); + +await client.api('/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/shifts/SHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion') + .version('beta') + .post(); + +``` \ No newline at end of file diff --git a/api-reference/v1.0/includes/snippets/javascript/timeoffstagefordeletion-javascript-snippets.md b/api-reference/v1.0/includes/snippets/javascript/timeoffstagefordeletion-javascript-snippets.md new file mode 100644 index 00000000000..0f28e4badac --- /dev/null +++ b/api-reference/v1.0/includes/snippets/javascript/timeoffstagefordeletion-javascript-snippets.md @@ -0,0 +1,17 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +--- + +```javascript + +const options = { + authProvider, +}; + +const client = Client.init(options); + +await client.api('/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/timesOff/SHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion') + .version('beta') + .post(); + +``` \ No newline at end of file From cbbfaf51645f1d362044674474ed84fdeb0c538a Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Tue, 12 Nov 2024 13:33:35 -0800 Subject: [PATCH 027/144] add ms.date --- api-reference/v1.0/api/openshift-post.md | 1 + api-reference/v1.0/api/openshift-update.md | 1 + 2 files changed, 2 insertions(+) diff --git a/api-reference/v1.0/api/openshift-post.md b/api-reference/v1.0/api/openshift-post.md index 3a76f0ebe7d..3f462cc2007 100644 --- a/api-reference/v1.0/api/openshift-post.md +++ b/api-reference/v1.0/api/openshift-post.md @@ -1,6 +1,7 @@ --- title: "Create openShift" description: "Create an instance of openShift object." +ms.date: 11/12/2024 ms.localizationpriority: medium author: "akumar39" ms.subservice: "teams" diff --git a/api-reference/v1.0/api/openshift-update.md b/api-reference/v1.0/api/openshift-update.md index 9f540dcf756..6697c0197ff 100644 --- a/api-reference/v1.0/api/openshift-update.md +++ b/api-reference/v1.0/api/openshift-update.md @@ -1,6 +1,7 @@ --- title: "Update openShift" description: "Update the properties of an openShift object." +ms.date: 11/12/2024 ms.localizationpriority: medium author: "akumar39" ms.subservice: "teams" From 1231d430267f054cd34c138a41a5a2bc24fad714 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Thu, 14 Nov 2024 11:46:06 +0000 Subject: [PATCH 028/144] improving acrolinx score --- api-reference/beta/resources/exchangerestoresession.md | 4 ++-- .../resources/onedriveforbusinessrestoresession.md | 8 ++++---- api-reference/beta/resources/restoresessionbase.md | 4 ++-- .../beta/resources/sharepointrestoresession.md | 10 +++++----- 4 files changed, 13 insertions(+), 13 deletions(-) diff --git a/api-reference/beta/resources/exchangerestoresession.md b/api-reference/beta/resources/exchangerestoresession.md index 27f20674094..fa4409e839c 100644 --- a/api-reference/beta/resources/exchangerestoresession.md +++ b/api-reference/beta/resources/exchangerestoresession.md @@ -36,8 +36,8 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |lastModifiedBy|[identitySet](../resources/identityset.md)|Identity of the person who last modified this restore session.| |lastModifiedDateTime|DateTimeOffset|Timestamp of last modification of this restore session.| |status|[restoreSessionStatus](../resources/exchangerestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| -|restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Indicates whether the restore sesssion was created normally or by a bulk job.| -|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoreSessionArtifactCount)|The number of metadata artifacts that belong to this restore session.| +|restoreJobType|[restoreJobType](../resources/enums.md#restorejobtype-values)|Indicates whether the restore sesssion was created normally or by a bulk job.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoresessionartifactcount)|The number of metadata artifacts that belong to this restore session.| ### restoreSessionStatus values |Member | Description | diff --git a/api-reference/beta/resources/onedriveforbusinessrestoresession.md b/api-reference/beta/resources/onedriveforbusinessrestoresession.md index a0cf525c1c2..054756e6c91 100644 --- a/api-reference/beta/resources/onedriveforbusinessrestoresession.md +++ b/api-reference/beta/resources/onedriveforbusinessrestoresession.md @@ -36,9 +36,9 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |error|[publicError](../resources/publicerror.md)|Contains error details if the restore session fails or completes with an error.| |lastModifiedBy|[identitySet](../resources/identityset.md)|Identity of the person who last modified this restore session.| |lastModifiedDateTime|DateTimeOffset|Timestamp of the last modification of this restore session.| -|status|[restoreSessionStatus](../resources/onedriveforbusinessrestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| -|restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Indicates whether the restore sesssion was created normally or by a bulk job.| -|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoreSessionArtifactCount)|The number of metadata artifacts that belong to this restore session.| +|status|[restoreSessionStatus](../resources/onedriveforbusinessrestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| +|restoreJobType|[restoreJobType](../resources/enums.md#restorejobtype-values)|Indicates whether the restore session was created normally or by a bulk job.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoresessionartifactcount)|The number of metadata artifacts that belong to this restore session.| ### restoreSessionStatus values @@ -50,7 +50,7 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |completedWithError|Some artifacts failed to restore, and some succeeded.| |completed| All restore artifacts successfully restored.| |failed| All restore artifacts failed to restore.| -|unknownFutureValue| Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue| Evolvable enumeration sentinel value. Don't use.| ## Relationships |Relationship|Type|Description| diff --git a/api-reference/beta/resources/restoresessionbase.md b/api-reference/beta/resources/restoresessionbase.md index 45f856e447d..a29cca2163a 100644 --- a/api-reference/beta/resources/restoresessionbase.md +++ b/api-reference/beta/resources/restoresessionbase.md @@ -40,8 +40,8 @@ Restoring to both a new location and the same URL in a single restore session is |lastModifiedBy|identitySet|Identity of the person who last modified the restore session.| |lastModifiedDateTime|DateTimeOffset|Timestamp of the last modification of the restore session.| |status|[restoreSessionStatus](../resources/restoresessionbase.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| -|restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Indicates whether the restore sesssion was created normally or by a bulk job.| -|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoreSessionArtifactCount)|The number of metadata artifacts that belong to this restore session.| +|restoreJobType|[restoreJobType](../resources/enums.md#restorejobtype-values)|Indicates whether the restore sesssion was created normally or by a bulk job.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoresessionartifactcount)|The number of metadata artifacts that belong to this restore session.| ### restoreSessionStatus values diff --git a/api-reference/beta/resources/sharepointrestoresession.md b/api-reference/beta/resources/sharepointrestoresession.md index 163aa71f81c..72c647acf64 100644 --- a/api-reference/beta/resources/sharepointrestoresession.md +++ b/api-reference/beta/resources/sharepointrestoresession.md @@ -1,6 +1,6 @@ --- title: "sharePointRestoreSession resource type" -description: "Represents restore-related tasks on artifacts that are protected by an SharePoint protection policy." +description: "Represents restore-related tasks on artifacts that are protected by a SharePoint protection policy." author: "tushar20" ms.reviewer: "manikantsinghms" ms.localizationpriority: medium @@ -38,9 +38,9 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |error|[publicError](../resources/publicerror.md)|Contains error details if the restore session fails or is completed with error.| |lastModifiedBy|[identitySet](../resources/identityset.md)|Identity of the person who last modified this restore session.| |lastModifiedDateTime|DateTimeOffset|Timestamp of last modification of this restore session.| -|status|[restoreSessionStatus](../resources/sharepointrestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of restore artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| -|restoreJobType|[restoreJobType](../resources/enums.md#restoreJobType-values)|Indicates whether the restore sesssion was created normally or by a bulk job.| -|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoreSessionArtifactCount)|The number of metadata artifacts that belong to this restore session.| +|status|[restoreSessionStatus](../resources/sharepointrestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of restore artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| +|restoreJobType|[restoreJobType](../resources/enums.md#restorejobtype-values)|Indicates whether the restore sesssion was created normally or by a bulk job.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoresessionartifactcount)|The number of metadata artifacts that belong to this restore session.| ### restoreSessionStatus values @@ -52,7 +52,7 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |completedWithError|Some artifacts failed to restore, and some succeeded.| |completed| All restore artifacts successfully restored.| |failed| All restore artifacts failed to restore.| -|unknownFutureValue| Evolvable enumeration sentinel value. Do not use.| +|unknownFutureValue| Evolvable enumeration sentinel value. Don't use.| ## Relationships From db191e80a7e601046f99b2203512cd73db020c8b Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Tue, 19 Nov 2024 10:16:26 +0000 Subject: [PATCH 029/144] creating new resource for restoreSessionArtifactCount --- .../beta/resources/exchangerestoresession.md | 2 +- .../onedriveforbusinessrestoresession.md | 2 +- .../resources/restoresessionartifactcount.md | 58 +++++++++++++++++++ .../beta/resources/restoresessionbase.md | 11 +--- .../resources/sharepointrestoresession.md | 2 +- 5 files changed, 62 insertions(+), 13 deletions(-) create mode 100644 api-reference/beta/resources/restoresessionartifactcount.md diff --git a/api-reference/beta/resources/exchangerestoresession.md b/api-reference/beta/resources/exchangerestoresession.md index fa4409e839c..0eea4d4c1aa 100644 --- a/api-reference/beta/resources/exchangerestoresession.md +++ b/api-reference/beta/resources/exchangerestoresession.md @@ -37,7 +37,7 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |lastModifiedDateTime|DateTimeOffset|Timestamp of last modification of this restore session.| |status|[restoreSessionStatus](../resources/exchangerestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| |restoreJobType|[restoreJobType](../resources/enums.md#restorejobtype-values)|Indicates whether the restore sesssion was created normally or by a bulk job.| -|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoresessionartifactcount)|The number of metadata artifacts that belong to this restore session.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionartifactcount.md)|The number of metadata artifacts that belong to this restore session.| ### restoreSessionStatus values |Member | Description | diff --git a/api-reference/beta/resources/onedriveforbusinessrestoresession.md b/api-reference/beta/resources/onedriveforbusinessrestoresession.md index 054756e6c91..05b36f1d5d6 100644 --- a/api-reference/beta/resources/onedriveforbusinessrestoresession.md +++ b/api-reference/beta/resources/onedriveforbusinessrestoresession.md @@ -38,7 +38,7 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |lastModifiedDateTime|DateTimeOffset|Timestamp of the last modification of this restore session.| |status|[restoreSessionStatus](../resources/onedriveforbusinessrestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| |restoreJobType|[restoreJobType](../resources/enums.md#restorejobtype-values)|Indicates whether the restore session was created normally or by a bulk job.| -|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoresessionartifactcount)|The number of metadata artifacts that belong to this restore session.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionartifactcount.md)|The number of metadata artifacts that belong to this restore session.| ### restoreSessionStatus values diff --git a/api-reference/beta/resources/restoresessionartifactcount.md b/api-reference/beta/resources/restoresessionartifactcount.md new file mode 100644 index 00000000000..5536ee0decb --- /dev/null +++ b/api-reference/beta/resources/restoresessionartifactcount.md @@ -0,0 +1,58 @@ +--- +title: "restoreSessionArtifactCount resource type" +description: "Represents artifact count metadata of a particular restoreSession" +author: "satpatel1" +ms.reviewer: "satpatel1" +ms.localizationpriority: medium +ms.subservice: "m365-backup-storage" +doc_type: resourcePageType +toc.title: RestoreSessionArtifactCount +--- + +# restoreSessionArtifactCount resource type + +Namespace: microsoft.graph + +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + +Represents Represents artifact count metadata of a particular [Restore Session](../resources/restoreSessionBase.md). Restore session APIs are used by SharePoint, OneDrive and Exchange Online Admins to perform restore-related tasks on artifacts that are protected as part of a protection policy. + +## Methods + +|Method|Return type|Description| +|:---|:---|:---| +|[Create](../api/backuprestoreroot-post-sharepointrestoresessions.md)|[sharePointRestoreSession](../resources/sharepointrestoresession.md)|Create a new [sharePointRestoreSession](../resources/sharepointrestoresession.md).| +|[Create](../api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md)|[oneDriveForBusinessRestoreSession](../resources/onedriveforbusinessrestoresessions.md)|Create a new [oneDriveForBusinessRestoreSession](../resources/onedriveforbusinessrestoresessions.md).| +|[Create](../api/backuprestoreroot-post-exchangerestoresessions.md)|[exchangeRestoreSession](../resources/exchangerestoresessions.md)|Create a new [exchangeRestoreSession](../resources/exchangerestoresessions.md).| +|[List](../api/backuprestoreroot-list-restoresessions.md)|[restoreSessionBase](../resources/restoresessionbase.md) collection|Get a list of [restoreSessionBase](../resources/restoresessionbase.md) objects and their properties.| +|[Get](../api/restoresessionbase-get.md)|[restoreSessionBase](../resources/restoresessionbase.md)|Read the properties and relationships of a [restoreSessionBase](../resources/restoresessionbase.md) object.| +|[Activate](../api/restoresessionbase-activate.md)|[restoreSessionBase](../resources/restoresessionbase.md)|Activate a draft restore session.| + +## Properties + +|Property|Type|Description| +|:---|:---|:---| +|total|Int32|Count of artifacts present in the restore session.| +|inProgress|Int32|Count of artifacts whose restore is in progress.| +|completed|Int32|Count of artifacts whose restore is completed.| +|failed|Int32|Count of artifacts whose restore is failed.| + +## JSON representation + +The following JSON representation shows the resource type. + +``` json +{ + "@odata.type": "#microsoft.graph.restoreSessionArtifactCount", + "total": "Int32", + "inProgress": "Int32", + "completed": "Int32", + "failed": "Int32" +} +``` diff --git a/api-reference/beta/resources/restoresessionbase.md b/api-reference/beta/resources/restoresessionbase.md index a29cca2163a..f3ec91cbf63 100644 --- a/api-reference/beta/resources/restoresessionbase.md +++ b/api-reference/beta/resources/restoresessionbase.md @@ -41,7 +41,7 @@ Restoring to both a new location and the same URL in a single restore session is |lastModifiedDateTime|DateTimeOffset|Timestamp of the last modification of the restore session.| |status|[restoreSessionStatus](../resources/restoresessionbase.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of the restored artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| |restoreJobType|[restoreJobType](../resources/enums.md#restorejobtype-values)|Indicates whether the restore sesssion was created normally or by a bulk job.| -|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoresessionartifactcount)|The number of metadata artifacts that belong to this restore session.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionartifactcount.md)|The number of metadata artifacts that belong to this restore session.| ### restoreSessionStatus values @@ -55,15 +55,6 @@ Restoring to both a new location and the same URL in a single restore session is |failed| All restore artifacts failed to restore.| |unknownFutureValue| Evolvable enumeration sentinel value. Don't use.| -### restoreSessionArtifactCount - -|Property |Type |Description | -|:------|:-----|:------------| -|total|Int32|The number of artifacts added in the restore session.| -|completed|Int32|The number of artifacts whose restore is complete.| -|inProgress|Int32|The number of artifacts whose restore is in progress.| -|failed|Int32|The number of artifacts whose restore failed.| - ## Relationships None. diff --git a/api-reference/beta/resources/sharepointrestoresession.md b/api-reference/beta/resources/sharepointrestoresession.md index 72c647acf64..5e85787a4b8 100644 --- a/api-reference/beta/resources/sharepointrestoresession.md +++ b/api-reference/beta/resources/sharepointrestoresession.md @@ -40,7 +40,7 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |lastModifiedDateTime|DateTimeOffset|Timestamp of last modification of this restore session.| |status|[restoreSessionStatus](../resources/sharepointrestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of restore artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| |restoreJobType|[restoreJobType](../resources/enums.md#restorejobtype-values)|Indicates whether the restore sesssion was created normally or by a bulk job.| -|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionbase.md#restoresessionartifactcount)|The number of metadata artifacts that belong to this restore session.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionartifactcount)|The number of metadata artifacts that belong to this restore session.| ### restoreSessionStatus values From 11fb07e02778cb28eb02ea461e1f13631820d859 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Tue, 19 Nov 2024 10:23:33 +0000 Subject: [PATCH 030/144] improving acrolinx score --- api-reference/beta/resources/restoresessionartifactcount.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/resources/restoresessionartifactcount.md b/api-reference/beta/resources/restoresessionartifactcount.md index 5536ee0decb..f853bafe4fe 100644 --- a/api-reference/beta/resources/restoresessionartifactcount.md +++ b/api-reference/beta/resources/restoresessionartifactcount.md @@ -15,7 +15,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents Represents artifact count metadata of a particular [Restore Session](../resources/restoreSessionBase.md). Restore session APIs are used by SharePoint, OneDrive and Exchange Online Admins to perform restore-related tasks on artifacts that are protected as part of a protection policy. +Represents artifact count metadata of a particular [Restore Session](../resources/restoreSessionBase.md). Restore session APIs are used by SharePoint, OneDrive, and Exchange Online Admins to perform restore-related tasks on artifacts that are protected as part of a protection policy. ## Methods @@ -32,7 +32,7 @@ Represents Represents artifact count metadata of a particular [Restore Session]( |Property|Type|Description| |:---|:---|:---| -|total|Int32|Count of artifacts present in the restore session.| +|total|Int32|Number of artifacts present in the restore session.| |inProgress|Int32|Count of artifacts whose restore is in progress.| |completed|Int32|Count of artifacts whose restore is completed.| |failed|Int32|Count of artifacts whose restore is failed.| From 39e32f3c4497102741ff14f864fcaf85ca04a6bd Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Tue, 19 Nov 2024 10:30:37 +0000 Subject: [PATCH 031/144] resolving doc errors --- api-reference/beta/resources/restoresessionartifactcount.md | 6 +++--- api-reference/beta/resources/sharepointrestoresession.md | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/api-reference/beta/resources/restoresessionartifactcount.md b/api-reference/beta/resources/restoresessionartifactcount.md index f853bafe4fe..be1bc430295 100644 --- a/api-reference/beta/resources/restoresessionartifactcount.md +++ b/api-reference/beta/resources/restoresessionartifactcount.md @@ -22,8 +22,8 @@ Represents artifact count metadata of a particular [Restore Session](../resource |Method|Return type|Description| |:---|:---|:---| |[Create](../api/backuprestoreroot-post-sharepointrestoresessions.md)|[sharePointRestoreSession](../resources/sharepointrestoresession.md)|Create a new [sharePointRestoreSession](../resources/sharepointrestoresession.md).| -|[Create](../api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md)|[oneDriveForBusinessRestoreSession](../resources/onedriveforbusinessrestoresessions.md)|Create a new [oneDriveForBusinessRestoreSession](../resources/onedriveforbusinessrestoresessions.md).| -|[Create](../api/backuprestoreroot-post-exchangerestoresessions.md)|[exchangeRestoreSession](../resources/exchangerestoresessions.md)|Create a new [exchangeRestoreSession](../resources/exchangerestoresessions.md).| +|[Create](../api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md)|[oneDriveForBusinessRestoreSession](../resources/onedriveforbusinessrestoresessions.md)|Create a new [oneDriveForBusinessRestoreSession](../resources/onedriveforbusinessrestoresession.md).| +|[Create](../api/backuprestoreroot-post-exchangerestoresessions.md)|[exchangeRestoreSession](../resources/exchangerestoresession.md)|Create a new [exchangeRestoreSession](../resources/exchangerestoresession.md).| |[List](../api/backuprestoreroot-list-restoresessions.md)|[restoreSessionBase](../resources/restoresessionbase.md) collection|Get a list of [restoreSessionBase](../resources/restoresessionbase.md) objects and their properties.| |[Get](../api/restoresessionbase-get.md)|[restoreSessionBase](../resources/restoresessionbase.md)|Read the properties and relationships of a [restoreSessionBase](../resources/restoresessionbase.md) object.| |[Activate](../api/restoresessionbase-activate.md)|[restoreSessionBase](../resources/restoresessionbase.md)|Activate a draft restore session.| @@ -43,7 +43,7 @@ The following JSON representation shows the resource type. diff --git a/api-reference/beta/resources/sharepointrestoresession.md b/api-reference/beta/resources/sharepointrestoresession.md index 5e85787a4b8..17417ac769e 100644 --- a/api-reference/beta/resources/sharepointrestoresession.md +++ b/api-reference/beta/resources/sharepointrestoresession.md @@ -40,7 +40,7 @@ Inherits from [restoreSessionBase](../resources/restoresessionbase.md). |lastModifiedDateTime|DateTimeOffset|Timestamp of last modification of this restore session.| |status|[restoreSessionStatus](../resources/sharepointrestoresession.md#restoresessionstatus-values)|Status of the restore session. The value is an aggregated status of restore artifacts. The possible values are: `draft`, `activating`, `active`, `completedWithError`, `completed`, `unknownFutureValue`, `failed`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `failed`.| |restoreJobType|[restoreJobType](../resources/enums.md#restorejobtype-values)|Indicates whether the restore sesssion was created normally or by a bulk job.| -|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionartifactcount)|The number of metadata artifacts that belong to this restore session.| +|restoreSessionArtifactCount|[restoreSessionArtifactCount](../resources/restoresessionartifactcount.md)|The number of metadata artifacts that belong to this restore session.| ### restoreSessionStatus values From b8e52e4e9e4e64a0c4a84f5aa7221df041bf6e81 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Tue, 19 Nov 2024 10:40:40 +0000 Subject: [PATCH 032/144] resolving errors --- api-reference/beta/resources/restoresessionartifactcount.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/api-reference/beta/resources/restoresessionartifactcount.md b/api-reference/beta/resources/restoresessionartifactcount.md index be1bc430295..308a12211ce 100644 --- a/api-reference/beta/resources/restoresessionartifactcount.md +++ b/api-reference/beta/resources/restoresessionartifactcount.md @@ -22,7 +22,7 @@ Represents artifact count metadata of a particular [Restore Session](../resource |Method|Return type|Description| |:---|:---|:---| |[Create](../api/backuprestoreroot-post-sharepointrestoresessions.md)|[sharePointRestoreSession](../resources/sharepointrestoresession.md)|Create a new [sharePointRestoreSession](../resources/sharepointrestoresession.md).| -|[Create](../api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md)|[oneDriveForBusinessRestoreSession](../resources/onedriveforbusinessrestoresessions.md)|Create a new [oneDriveForBusinessRestoreSession](../resources/onedriveforbusinessrestoresession.md).| +|[Create](../api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md)|[oneDriveForBusinessRestoreSession](../resources/onedriveforbusinessrestoresession.md)|Create a new [oneDriveForBusinessRestoreSession](../resources/onedriveforbusinessrestoresession.md).| |[Create](../api/backuprestoreroot-post-exchangerestoresessions.md)|[exchangeRestoreSession](../resources/exchangerestoresession.md)|Create a new [exchangeRestoreSession](../resources/exchangerestoresession.md).| |[List](../api/backuprestoreroot-list-restoresessions.md)|[restoreSessionBase](../resources/restoresessionbase.md) collection|Get a list of [restoreSessionBase](../resources/restoresessionbase.md) objects and their properties.| |[Get](../api/restoresessionbase-get.md)|[restoreSessionBase](../resources/restoresessionbase.md)|Read the properties and relationships of a [restoreSessionBase](../resources/restoresessionbase.md) object.| @@ -43,7 +43,6 @@ The following JSON representation shows the resource type. From 4335507c75790898f83aefa8fcc3f6a8daa3c8e7 Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Thu, 21 Nov 2024 10:09:55 -0800 Subject: [PATCH 033/144] add log --- changelog/Microsoft.Teams.Shifts.json | 83 +++++++++++++++++++++++++++ 1 file changed, 83 insertions(+) diff --git a/changelog/Microsoft.Teams.Shifts.json b/changelog/Microsoft.Teams.Shifts.json index f19fdae5bd1..38c0d8a3517 100644 --- a/changelog/Microsoft.Teams.Shifts.json +++ b/changelog/Microsoft.Teams.Shifts.json @@ -651,6 +651,89 @@ "CreatedDateTime": "2024-02-16T11:22:07.883123Z", "WorkloadArea": "Teamwork and communications", "SubArea": "Shift management" + }, + { + "ChangeList": [ + { + "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "ApiChange": "Enumeration", + "ChangedApiName": "eligibilityFilteringEnabledEntities", + "ChangeType": "Addition", + "Description": "Added the **eligibilityFilteringEnabledEntities** enumeration type.", + "Target": "eligibilityFilteringEnabledEntities" + }, + { + "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "ApiChange": "Member", + "ChangedApiName": "timeOffReason", + "ChangeType": "Addition", + "Description": "Added the `timeOffReason` member to the **workforceIntegrationSupportedEntities** enumeration.", + "Target": "workforceIntegrationSupportedEntities" + }, + { + "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "ApiChange": "Member", + "ChangedApiName": "timeOff", + "ChangeType": "Addition", + "Description": "Added the `timeOff` member to the **workforceIntegrationSupportedEntities** enumeration.", + "Target": "workforceIntegrationSupportedEntities" + }, + { + "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "ApiChange": "Member", + "ChangedApiName": "timeOffRequest", + "ChangeType": "Addition", + "Description": "Added the `timeOffRequest` member to the **workforceIntegrationSupportedEntities** enumeration.", + "Target": "workforceIntegrationSupportedEntities" + }, + { + "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "ApiChange": "Property", + "ChangedApiName": "isStagedForDeletion", + "ChangeType": "Addition", + "Description": "Added the **isStagedForDeletion** property to the [openShift](https://learn.microsoft.com/en-us/graph/api/resources/openShift?view=graph-rest-1.0) resource.", + "Target": "openShift" + }, + { + "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "ApiChange": "Property", + "ChangedApiName": "isStagedForDeletion", + "ChangeType": "Addition", + "Description": "Added the **isStagedForDeletion** property to the [shift](https://learn.microsoft.com/en-us/graph/api/resources/shift?view=graph-rest-1.0) resource.", + "Target": "shift" + }, + { + "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "ApiChange": "Property", + "ChangedApiName": "isStagedForDeletion", + "ChangeType": "Addition", + "Description": "Added the **isStagedForDeletion** property to the [timeOff](https://learn.microsoft.com/en-us/graph/api/resources/timeOff?view=graph-rest-1.0) resource.", + "Target": "timeOff" + }, + { + "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "ApiChange": "Property", + "ChangedApiName": "eligibilityFilteringEnabledEntities", + "ChangeType": "Addition", + "Description": "Added the **eligibilityFilteringEnabledEntities** property to the [workforceIntegration](https://learn.microsoft.com/en-us/graph/api/resources/workforceIntegration?view=graph-rest-1.0) resource.", + "Target": "workforceIntegration" + }, + { + "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "ApiChange": "Method", + "ChangedApiName": "stageForDeletion", + "ChangeType": "Addition", + "Description": "Added the [stageForDeletion](https://learn.microsoft.com/en-us/graph/api/changeTrackedEntity-stageForDeletion?view=graph-rest-1.0) method to the [changeTrackedEntity](https://learn.microsoft.com/en-us/graph/api/resources/changeTrackedEntity?view=graph-rest-1.0) resource.", + "Target": "changeTrackedEntity" + } + ], + "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "Cloud": "Review", + "Version": "v1.0", + "CreatedDateTime": "2024-11-21T06:19:39.9488203Z", + "WorkloadArea": "Teamwork", + "SubArea": "" } + ] } \ No newline at end of file From 332a25fb6f68b68b2cc66616c787535dde3de697 Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Thu, 21 Nov 2024 11:04:45 -0800 Subject: [PATCH 034/144] fix comment --- api-reference/v1.0/api/openshift-get.md | 37 ++++++++---- api-reference/v1.0/api/openshift-list.md | 56 +++++++++---------- .../v1.0/api/schedule-list-shifts.md | 46 +++++++++------ .../v1.0/api/schedule-post-shifts.md | 8 +-- .../v1.0/api/schedule-post-timesoff.md | 4 +- api-reference/v1.0/api/shift-get.md | 28 +++++----- api-reference/v1.0/api/timeoff-get.md | 41 +++++++++----- .../v1.0/api/workforceintegration-get.md | 36 +++++++----- .../v1.0/api/workforceintegration-list.md | 47 +++++++++------- 9 files changed, 177 insertions(+), 126 deletions(-) diff --git a/api-reference/v1.0/api/openshift-get.md b/api-reference/v1.0/api/openshift-get.md index 1d5eb8c5073..63fbfe78791 100644 --- a/api-reference/v1.0/api/openshift-get.md +++ b/api-reference/v1.0/api/openshift-get.md @@ -119,21 +119,36 @@ HTTP/1.1 200 OK Content-Type: application/json { - "@odata.type": "#microsoft.graph.openShift", - "id": "String (identifier)", - "createdDateTime": "String (timestamp)", - "lastModifiedDateTime": "String (timestamp)", + "id": "OPNSHFT_d8da84aa-0138-45f9-9ac7-5d06712211d3", + "createdDateTime": "2024-11-08T22:11:18.091Z", + "lastModifiedDateTime": "2024-11-08T22:11:18.091Z", + "schedulingGroupId": "TAG_4ab7d329-1f7e-4eaf-ba93-63f1ff3f3c4a", + "isStagedForDeletion": false, + "draftOpenShift": null, "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" + "application": null, + "device": null, + "user": { + "id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8", + "displayName": "John Doe", + "userIdentityType": "aadUser", + "tenantId": null + } }, "sharedOpenShift": { - "@odata.type": "microsoft.graph.openShiftItem" + "displayName": null, + "startDateTime": "2024-11-04T20:00:00Z", + "endDateTime": "2024-11-04T21:00:00Z", + "theme": "blue", + "notes": null, + "openSlotCount": 1, + "activities": [] }, - "draftOpenShift": { - "@odata.type": "microsoft.graph.openShiftItem" - }, - "schedulingGroupId": "String", - "isStagedForDeletion": "Boolean" + "schedulingGroupInfo": { + "displayName": "", + "schedulingGroupId": "TAG_4ab7d329-1f7e-4eaf-ba93-63f1ff3f3c4a", + "code": null + } } ``` diff --git a/api-reference/v1.0/api/openshift-list.md b/api-reference/v1.0/api/openshift-list.md index 7e1ec76b5a0..f68114d057e 100644 --- a/api-reference/v1.0/api/openshift-list.md +++ b/api-reference/v1.0/api/openshift-list.md @@ -121,39 +121,37 @@ Content-type: application/json { "value": [ { - "@odata.type": "#microsoft.graph.openShift", - "id": "String (identifier)", - "createdDateTime": "String (timestamp)", - "lastModifiedDateTime": "String (timestamp)", + "id": "OPNSHFT_d8da84aa-0138-45f9-9ac7-5d06712211d3", + "createdDateTime": "2024-11-08T22:11:18.091Z", + "lastModifiedDateTime": "2024-11-08T22:11:18.091Z", + "schedulingGroupId": "TAG_4ab7d329-1f7e-4eaf-ba93-63f1ff3f3c4a", + "isStagedForDeletion": false, + "draftOpenShift": null, "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" + "application": null, + "device": null, + "user": { + "id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8", + "displayName": "John Doe", + "userIdentityType": "aadUser", + "tenantId": null + } }, "sharedOpenShift": { - "@odata.type": "microsoft.graph.openShiftItem" + "displayName": null, + "startDateTime": "2024-11-04T20:00:00Z", + "endDateTime": "2024-11-04T21:00:00Z", + "theme": "blue", + "notes": null, + "openSlotCount": 1, + "activities": [] }, - "draftOpenShift": { - "@odata.type": "microsoft.graph.openShiftItem" - }, - "schedulingGroupId": "String", - "isStagedForDeletion": "Boolean" - }, - { - "@odata.type": "#microsoft.graph.openShift", - "id": "String (identifier)", - "createdDateTime": "String (timestamp)", - "lastModifiedDateTime": "String (timestamp)", - "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" - }, - "sharedOpenShift": { - "@odata.type": "microsoft.graph.openShiftItem" - }, - "draftOpenShift": { - "@odata.type": "microsoft.graph.openShiftItem" - }, - "schedulingGroupId": "String", - "isStagedForDeletion": "Boolean" - } + "schedulingGroupInfo": { + "displayName": "", + "schedulingGroupId": "TAG_4ab7d329-1f7e-4eaf-ba93-63f1ff3f3c4a", + "code": null + } + } ] } ``` diff --git a/api-reference/v1.0/api/schedule-list-shifts.md b/api-reference/v1.0/api/schedule-list-shifts.md index 15449682d8c..f81890d72b0 100644 --- a/api-reference/v1.0/api/schedule-list-shifts.md +++ b/api-reference/v1.0/api/schedule-list-shifts.md @@ -122,22 +122,36 @@ Content-type: application/json { "value": [ { - "@odata.type": "#microsoft.graph.shift", - "id": "179a8570-a463-293f-15a2-0bba4cdca4d8", - "createdDateTime": "String (timestamp)", - "lastModifiedDateTime": "String (timestamp)", - "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" - }, - "sharedShift": { - "@odata.type": "microsoft.graph.shiftItem" - }, - "draftShift": { - "@odata.type": "microsoft.graph.shiftItem" - }, - "userId": "String", - "schedulingGroupId": "String", - "isStagedForDeletion": "Boolean" + "id": "SHFT_b986be48-7396-4ea4-ad62-470e18d9d2f1", + "createdDateTime": "2024-10-10T19:40:59.924Z", + "lastModifiedDateTime": "2024-10-10T19:40:59.924Z", + "schedulingGroupId": "TAG_4ab7d329-1f7e-4eaf-ba93-63f1ff3f3c4a", + "userId": "5ca83ce7-291d-43b7-bf53-af79eef4bc1d", + "isStagedForDeletion": false, + "sharedShift": null, + "lastModifiedBy": { + "application": null, + "device": null, + "user": { + "id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8", + "displayName": "John Doe", + "userIdentityType": "aadUser", + "tenantId": null + } + }, + "draftShift": { + "displayName": null, + "startDateTime": "2024-10-08T15:00:00Z", + "endDateTime": "2024-10-09T00:00:00Z", + "theme": "blue", + "notes": null, + "activities": [] + }, + "schedulingGroupInfo": { + "displayName": "", + "schedulingGroupId": "TAG_4ab7d329-1f7e-4eaf-ba93-63f1ff3f3c4a", + "code": null + }, } ] } diff --git a/api-reference/v1.0/api/schedule-post-shifts.md b/api-reference/v1.0/api/schedule-post-shifts.md index d67fa9ffe84..62ac9b36d4f 100644 --- a/api-reference/v1.0/api/schedule-post-shifts.md +++ b/api-reference/v1.0/api/schedule-post-shifts.md @@ -135,20 +135,18 @@ HTTP/1.1 201 Created Content-type: application/json { - "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('48ba9e52-8d25-41c7-bbe7-5ee6346eec0d')/schedule/shifts/$entity", - "@odata.etag": "\"40022efe-0000-0c00-0000-672ea37a0000\"", "id": "SHFT_0f004eda-32a6-4f0c-a076-18f76d997a55", "createdDateTime": "2024-11-08T23:49:13.877Z", "lastModifiedDateTime": "2024-11-08T23:49:13.877Z", - "schedulingGroupId": null, + "schedulingGroupId": "TAG_4ab7d329-1f7e-4eaf-ba93-63f1ff3f3c4a", "userId": "5ca83ce7-291d-43b7-bf53-af79eef4bc1d", "sharedShift": null, "lastModifiedBy": { "application": null, "device": null, "user": { - "id": "aa162a04-bec6-4b81-ba99-96caa7b2b24d", - "displayName": "victorcheng", + "id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8", + "displayName": "John Doe", "userIdentityType": "aadUser", "tenantId": null } diff --git a/api-reference/v1.0/api/schedule-post-timesoff.md b/api-reference/v1.0/api/schedule-post-timesoff.md index 52f5ff018d6..817e1e58bde 100644 --- a/api-reference/v1.0/api/schedule-post-timesoff.md +++ b/api-reference/v1.0/api/schedule-post-timesoff.md @@ -145,8 +145,8 @@ Content-type: application/json "application": null, "device": null, "user": { - "id": "aa162a04-bec6-4b81-ba99-96caa7b2b24d", - "displayName": "victorcheng", + "id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8", + "displayName": "John Doe", "userIdentityType": "aadUser", "tenantId": null } diff --git a/api-reference/v1.0/api/shift-get.md b/api-reference/v1.0/api/shift-get.md index 6c215bed605..a33cbf0e863 100644 --- a/api-reference/v1.0/api/shift-get.md +++ b/api-reference/v1.0/api/shift-get.md @@ -114,22 +114,22 @@ HTTP/1.1 200 OK Content-type: application/json { - "@odata.type": "#microsoft.graph.shift", - "id": "String (identifier)", - "createdDateTime": "String (timestamp)", - "lastModifiedDateTime": "String (timestamp)", + "id": "SHFT_ca485cdd-a42c-4b93-9e6a-6fa54fd45fe1", + "createdDateTime": "2019-06-06T20:15:38.9Z", + "lastModifiedDateTime": "2019-11-18T01:12:08.318Z", + "schedulingGroupId": "TAG_d18fd675-3ac8-41b2-8038-d17fdac8b0d3", + "userId": "a7b0c8c4-3f5c-492f-ab13-40f0e0f0ffa8", + "draftShift": null, "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" + "application": null, + "device": null, + "conversation": null, + "user": { + "id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8", + "displayName": "John Doe", + } }, - "sharedShift": { - "@odata.type": "microsoft.graph.shiftItem" - }, - "draftShift": { - "@odata.type": "microsoft.graph.shiftItem" - }, - "userId": "String", - "schedulingGroupId": "String", - "isStagedForDeletion": "Boolean" + "isStagedForDeletion": false } ``` diff --git a/api-reference/v1.0/api/timeoff-get.md b/api-reference/v1.0/api/timeoff-get.md index 313b73f5bbd..21b35f1be94 100644 --- a/api-reference/v1.0/api/timeoff-get.md +++ b/api-reference/v1.0/api/timeoff-get.md @@ -116,21 +116,32 @@ HTTP/1.1 200 OK Content-type: application/json { - "@odata.type": "#microsoft.graph.timeOff", - "id": "d8aa6cc9-7a1a-fb34-ed9c-e1ac3dcd54c8", - "createdDateTime": "String (timestamp)", - "lastModifiedDateTime": "String (timestamp)", - "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" - }, - "sharedTimeOff": { - "@odata.type": "microsoft.graph.timeOffItem" - }, - "draftTimeOff": { - "@odata.type": "microsoft.graph.timeOffItem" - }, - "userId": "String", - "isStagedForDeletion": "Boolean" + "userId": "c5d0c76b-80c4-481c-be50-923cd8d680a1", + "id": "d8aa6cc9-7a1a-fb34-ed9c-e1ac3dcd54c8", + "createdDateTime": "2019-03-14T05:35:57.755Z", + "lastModifiedDateTime": "2019-03-14T05:36:08.381Z", + "lastModifiedBy": { + "application": null, + "device": null, + "conversation": null, + "user": { + "id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8", + "displayName": "John Doe" + } + }, + "sharedTimeOff": { + "timeOffReasonId": "TOR_891045ca-b5d2-406b-aa06-a3c8921245d7", + "startDateTime": "2019-03-11T07:00:00Z", + "endDateTime": "2019-03-12T07:00:00Z", + "theme": "white" + }, + "draftTimeOff": { + "timeOffReasonId": "TOR_891045ca-b5d2-406b-aa06-a3c8921245d7", + "startDateTime": "2019-03-11T07:00:00Z", + "endDateTime": "2019-03-12T07:00:00Z", + "theme": "pink" + }, + "isStagedForDeletion": false } ``` diff --git a/api-reference/v1.0/api/workforceintegration-get.md b/api-reference/v1.0/api/workforceintegration-get.md index 7578d5eddcb..9607891a0b4 100644 --- a/api-reference/v1.0/api/workforceintegration-get.md +++ b/api-reference/v1.0/api/workforceintegration-get.md @@ -119,24 +119,30 @@ HTTP/1.1 200 OK Content-Type: application/json { - "value": { - "@odata.type": "#microsoft.graph.workforceIntegration", - "id": "b1871d36-f682-351b-9754-79b5e55bd345", - "createdDateTime": "String (timestamp)", - "lastModifiedDateTime": "String (timestamp)", + "id": "WFI_05227533-379e-4a0a-9d17-afe306a1e10d", + "createdDateTime": "2021-03-12T17:37:05.84Z", + "lastModifiedDateTime": "2021-06-21T11:13:12.288Z", + "displayName": "test", + "url": "https://contosoWorkforceIntegration.com/Contoso/", + "apiVersion": 1, + "isActive": true, + "supports": "shift,swapRequest,userShiftPreferences,openShift,openShiftRequest", + "supportedEntities": "shift,swapRequest,userShiftPreferences,openShift,openShiftRequest", + "eligibilityFilteringEnabledEntities": "none", "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" + "application": null, + "device": null, + "user": { + "id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8", + "displayName": "John Doe", + "userIdentityType": "aadUser", + "tenantId": null + } }, - "displayName": "String", - "apiVersion": "Integer", "encryption": { - "@odata.type": "microsoft.graph.workforceIntegrationEncryption" - }, - "isActive": "Boolean", - "url": "String", - "supportedEntities": "String", - "eligibilityFilteringEnabledEntities": "String" - } + "protocol": "sharedSecret", + "secret": null + } } ``` diff --git a/api-reference/v1.0/api/workforceintegration-list.md b/api-reference/v1.0/api/workforceintegration-list.md index b37b1dbb4f2..fd69a5af5a2 100644 --- a/api-reference/v1.0/api/workforceintegration-list.md +++ b/api-reference/v1.0/api/workforceintegration-list.md @@ -121,25 +121,34 @@ HTTP/1.1 200 OK Content-type: application/json { - "value": { - "@odata.type": "#microsoft.graph.workforceIntegration", - "id": "b1871d36-f682-351b-9754-79b5e55bd345", - "createdDateTime": "String (timestamp)", - "lastModifiedDateTime": "String (timestamp)", - "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" - }, - "displayName": "String", - "apiVersion": "Integer", - "encryption": { - "@odata.type": "microsoft.graph.workforceIntegrationEncryption" - }, - "isActive": "Boolean", - "url": "String", - "supportedEntities": "String", - "eligibilityFilteringEnabledEntities": "String" - } -} ] + "value": [ + { + "id": "WFI_05227533-379e-4a0a-9d17-afe306a1e10d", + "createdDateTime": "2021-03-12T17:37:05.84Z", + "lastModifiedDateTime": "2021-06-21T11:13:12.288Z", + "displayName": "test", + "url": "https://contosoWorkforceIntegration.com/Contoso/", + "apiVersion": 1, + "isActive": true, + "supports": "shift,swapRequest,userShiftPreferences,openShift,openShiftRequest", + "supportedEntities": "shift,swapRequest,userShiftPreferences,openShift,openShiftRequest", + "eligibilityFilteringEnabledEntities": "none", + "lastModifiedBy": { + "application": null, + "device": null, + "user": { + "id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8", + "displayName": "John Doe", + "userIdentityType": "aadUser", + "tenantId": null + } + }, + "encryption": { + "protocol": "sharedSecret", + "secret": null + } + } + ] } ``` From 9296546c1d399c62385be3ebe848a59b4f5d7709 Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Thu, 21 Nov 2024 11:30:40 -0800 Subject: [PATCH 035/144] fix warning --- .../v1.0/api/changetrackedentity-stagefordeletion.md | 3 ++- api-reference/v1.0/api/openshift-post.md | 6 +++--- api-reference/v1.0/api/schedule-post-shifts.md | 7 ++++--- api-reference/v1.0/api/schedule-post-timesoff.md | 7 ++++--- api-reference/v1.0/api/shift-get.md | 3 ++- api-reference/v1.0/api/shift-put.md | 7 ++++--- api-reference/v1.0/api/timeoff-put.md | 4 ++-- api-reference/v1.0/api/workforceintegration-post.md | 2 +- api-reference/v1.0/api/workforceintegration-update.md | 2 +- api-reference/v1.0/resources/changetrackedentity.md | 3 ++- api-reference/v1.0/resources/enums.md | 1 + api-reference/v1.0/resources/openshift.md | 5 +++-- api-reference/v1.0/resources/shift.md | 3 ++- api-reference/v1.0/resources/timeoff.md | 3 ++- api-reference/v1.0/resources/workforceintegration.md | 3 ++- 15 files changed, 35 insertions(+), 24 deletions(-) diff --git a/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md b/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md index 5f0d5ecd22b..359bd3c6594 100644 --- a/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md +++ b/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md @@ -1,7 +1,8 @@ --- title: "changeTrackedEntity: stageForDeletion" description: "Stage the deletion of an openShift, shift, or timeOff instance in a [schedule](../resources/schedule.md) in draft mode." -author: "raulfernandes" +ms.date: 11/21/2024 +author: "victorcheng" ms.localizationpriority: medium ms.subservice: "teams" doc_type: apiPageType diff --git a/api-reference/v1.0/api/openshift-post.md b/api-reference/v1.0/api/openshift-post.md index 3f462cc2007..fddf31fd2c9 100644 --- a/api-reference/v1.0/api/openshift-post.md +++ b/api-reference/v1.0/api/openshift-post.md @@ -1,9 +1,9 @@ --- title: "Create openShift" description: "Create an instance of openShift object." -ms.date: 11/12/2024 +ms.date: 11/21/2024 +author: "victorcheng" ms.localizationpriority: medium -author: "akumar39" ms.subservice: "teams" doc_type: "apiPageType" --- @@ -164,7 +164,7 @@ Content-Type: application/json "openSlotCount": 1, "activities": [] }, - isStagedForDeletion: false + "isStagedForDeletion": false } ``` diff --git a/api-reference/v1.0/api/schedule-post-shifts.md b/api-reference/v1.0/api/schedule-post-shifts.md index 62ac9b36d4f..e57ec1b7679 100644 --- a/api-reference/v1.0/api/schedule-post-shifts.md +++ b/api-reference/v1.0/api/schedule-post-shifts.md @@ -1,7 +1,8 @@ --- title: "Create shift" description: "Create a new shift." -author: "akumar39" +ms.date: 11/21/2024 +author: "victorcheng" ms.localizationpriority: medium ms.subservice: "teams" doc_type: apiPageType @@ -44,10 +45,10 @@ POST /teams/{teamId}/schedule/shifts |Property|Type|Description| |:---|:---|:---| -| draftShift | [shiftItem](shiftitem.md) | Draft changes in the **shift**. Draft changes are only visible to managers. The changes are visible to employees when they're [shared](../api/schedule-share.md), which copies the changes from the **draftShift** to the **sharedShift** property. Eiher draShift or sharedShift should be null.| +| draftShift | [shiftItem](../resources/shiftitem.md) | Draft changes in the **shift**. Draft changes are only visible to managers. The changes are visible to employees when they're [shared](../api/schedule-share.md), which copies the changes from the **draftShift** to the **sharedShift** property. Eiher draShift or sharedShift should be null.| | isStagedForDeletion | Boolean | The **shift** is marked for deletion, a process that is finalized when the schedule is [shared](../api/schedule-share.md). Optional. | | schedulingGroupId | String | ID of the scheduling group the **shift** is part of. Required. | -| sharedShift | [shiftItem](shiftitem.md) | The shared version of this **shift** that is viewable by both employees and managers. Updates to the **sharedShift** property send notifications to users in the Teams client. Eiher draShift or sharedShift should be null.| +| sharedShift | [shiftItem](../resources/shiftitem.md) | The shared version of this **shift** that is viewable by both employees and managers. Updates to the **sharedShift** property send notifications to users in the Teams client. Eiher draShift or sharedShift should be null.| | userId | String | ID of the user assigned to the **shift**. Required. | ## Response diff --git a/api-reference/v1.0/api/schedule-post-timesoff.md b/api-reference/v1.0/api/schedule-post-timesoff.md index 817e1e58bde..4520d88913d 100644 --- a/api-reference/v1.0/api/schedule-post-timesoff.md +++ b/api-reference/v1.0/api/schedule-post-timesoff.md @@ -1,7 +1,8 @@ --- title: "Create timeOff" description: "Create a new timeOff." -author: "akumar39" +ms.date: 11/21/2024 +author: "victorcheng" ms.localizationpriority: medium ms.subservice: "teams" doc_type: apiPageType @@ -46,9 +47,9 @@ In the request body, supply a modified JSON representation of a [timeOff](../res |Property|Type|Description| |:---|:---|:---| -| draftTimeOff | [timeOffItem](timeoffitem.md) |The draft version of this **timeOff** item that is viewable by managers. It must be shared before it is visible to team members. Either draftTimeOff or sharedTimeOff should be null.| +| draftTimeOff | [timeOffItem](../resources/timeoffitem.md) |The draft version of this **timeOff** item that is viewable by managers. It must be shared before it is visible to team members. Either draftTimeOff or sharedTimeOff should be null.| | isStagedForDeletion | Boolean | The **timeOff** is marked for deletion, a process that is finalized when the schedule is [shared](../api/schedule-share.md). Optional| -| sharedTimeOff | [timeOffItem](timeoffitem.md) |The shared version of this **timeOff** that is viewable by both employees and managers. Updates to the **sharedTimeOff** property send notifications to users in the Teams client. Either draftTimeOff or sharedTimeOff should be null.| +| sharedTimeOff | [timeOffItem](../resources/timeoffitem.md) |The shared version of this **timeOff** that is viewable by both employees and managers. Updates to the **sharedTimeOff** property send notifications to users in the Teams client. Either draftTimeOff or sharedTimeOff should be null.| | userId | String |ID of the user assigned to the **timeOff**. Required.| ## Response diff --git a/api-reference/v1.0/api/shift-get.md b/api-reference/v1.0/api/shift-get.md index a33cbf0e863..87f274abd1c 100644 --- a/api-reference/v1.0/api/shift-get.md +++ b/api-reference/v1.0/api/shift-get.md @@ -1,7 +1,8 @@ --- title: "Get shift" description: "Get a shift by ID." -author: "akumar39" +ms.date: 11/21/2024 +author: "victorcheng" ms.localizationpriority: medium ms.subservice: "teams" doc_type: apiPageType diff --git a/api-reference/v1.0/api/shift-put.md b/api-reference/v1.0/api/shift-put.md index 04819351109..f370880b6ed 100644 --- a/api-reference/v1.0/api/shift-put.md +++ b/api-reference/v1.0/api/shift-put.md @@ -1,7 +1,8 @@ --- title: "Replace shift" description: "Replace an existing shift." -author: "akumar39" +ms.date: 11/21/2024 +author: "victorcheng" ms.localizationpriority: medium ms.subservice: "teams" doc_type: apiPageType @@ -44,10 +45,10 @@ PUT /teams/{teamId}/schedule/shifts/{shiftId} |Property|Type|Description| |:---|:---|:---| -| draftShift | [shiftItem](shiftitem.md) | Draft changes in the **shift**. Draft changes are only visible to managers. The changes are visible to employees when they're [shared](../api/schedule-share.md), which copies the changes from the **draftShift** to the **sharedShift** property. Eiher draShift or sharedShift should be null. | +| draftShift | [shiftItem](../resources/shiftitem.md) | Draft changes in the **shift**. Draft changes are only visible to managers. The changes are visible to employees when they're [shared](../api/schedule-share.md), which copies the changes from the **draftShift** to the **sharedShift** property. Eiher draShift or sharedShift should be null. | | isStagedForDeletion | Boolean | The **shift** is marked for deletion, a process that is finalized when the schedule is [shared](../api/schedule-share.md). Optional. | | schedulingGroupId | String | ID of the scheduling group the **shift** is part of. Required. | -| sharedShift | [shiftItem](shiftitem.md) | The shared version of this **shift** that is viewable by both employees and managers. Updates to the **sharedShift** property send notifications to users in the Teams client. Eiher draShift or sharedShift should be null.| +| sharedShift | [shiftItem](../resources/shiftitem.md) | The shared version of this **shift** that is viewable by both employees and managers. Updates to the **sharedShift** property send notifications to users in the Teams client. Eiher draShift or sharedShift should be null.| | userId | String | ID of the user assigned to the **shift**. Required. | ## Response diff --git a/api-reference/v1.0/api/timeoff-put.md b/api-reference/v1.0/api/timeoff-put.md index 664dfb4bb80..2da5322799d 100644 --- a/api-reference/v1.0/api/timeoff-put.md +++ b/api-reference/v1.0/api/timeoff-put.md @@ -46,9 +46,9 @@ In the request body, supply a modified JSON representation of a [timeOff](../res |Property|Type|Description| |:---|:---|:---| -| draftTimeOff | [timeOffItem](timeoffitem.md) |The draft version of this **timeOff** item that is viewable by managers. It must be shared before it is visible to team members. Either draftTimeOff or sharedTimeOff should be null.| +| draftTimeOff | [timeOffItem](../resources/timeoffitem.md) |The draft version of this **timeOff** item that is viewable by managers. It must be shared before it is visible to team members. Either draftTimeOff or sharedTimeOff should be null.| | isStagedForDeletion | Boolean | The **timeOff** is marked for deletion, a process that is finalized when the schedule is [shared](../api/schedule-share.md). Optional| -| sharedTimeOff | [timeOffItem](timeoffitem.md) |The shared version of this **timeOff** that is viewable by both employees and managers. Updates to the **sharedTimeOff** property send notifications to users in the Teams client. Either draftTimeOff or sharedTimeOff should be null.| +| sharedTimeOff | [timeOffItem](../resources/timeoffitem.md) |The shared version of this **timeOff** that is viewable by both employees and managers. Updates to the **sharedTimeOff** property send notifications to users in the Teams client. Either draftTimeOff or sharedTimeOff should be null.| | userId | String |ID of the user assigned to the **timeOff**. Required.| diff --git a/api-reference/v1.0/api/workforceintegration-post.md b/api-reference/v1.0/api/workforceintegration-post.md index fd426ef072c..861afac9ba8 100644 --- a/api-reference/v1.0/api/workforceintegration-post.md +++ b/api-reference/v1.0/api/workforceintegration-post.md @@ -50,7 +50,7 @@ In the request body, supply the values for relevant fields that should be update |apiVersion|Int32|API version for the call back URL. Start with 1.| |displayName|String|Name of the workforce integration.| |eligibilityFilteringEnabledEntities|eligibilityFilteringEnabledEntities| Support to view eligibility-filtered results. Possible values are: `none`, `swapRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason`.| -|encryption|[workforceIntegrationEncryption](workforceintegrationencryption.md)|The workforce integration encryption resource.| +|encryption|[workforceIntegrationEncryption](../resources/workforceintegrationencryption.md)|The workforce integration encryption resource.| |isActive|Boolean|Indicates whether this workforce integration is currently active and available.| |supportedEntities|workforceIntegrationSupportedEntities | The Shifts entities supported for synchronous change notifications. Shifts will make a call back to the url provided on client changes on those entities added here. By default, no entities are supported for change notifications. Possible values are: `none`, `shift`, `swapRequest`, `userShiftPreferences`, `openShift`, `openShiftRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`, `timeOff`, `timeOffRequest`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason` , `timeOff` , `timeOffRequest`.| |url|String| Workforce Integration URL for callbacks from the Shifts service.| diff --git a/api-reference/v1.0/api/workforceintegration-update.md b/api-reference/v1.0/api/workforceintegration-update.md index 6d08e57d3da..2a8bca0942c 100644 --- a/api-reference/v1.0/api/workforceintegration-update.md +++ b/api-reference/v1.0/api/workforceintegration-update.md @@ -48,7 +48,7 @@ In the request body, supply the values for relevant fields that should be update |apiVersion|Int32|API version for the call back URL. Start with 1.| |displayName|String|Name of the workforce integration.| |eligibilityFilteringEnabledEntities|eligibilityFilteringEnabledEntities| Support to view eligibility-filtered results. Possible values are: `none`, `swapRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason`.| -|encryption|[workforceIntegrationEncryption](workforceintegrationencryption.md)|The workforce integration encryption resource.| +|encryption|[workforceIntegrationEncryption](../resources/workforceintegrationencryption.md)|The workforce integration encryption resource.| |isActive|Boolean|Indicates whether this workforce integration is currently active and available.| |supportedEntities|workforceIntegrationSupportedEntities | The Shifts entities supported for synchronous change notifications. Shifts will make a call back to the url provided on client changes on those entities added here. By default, no entities are supported for change notifications. Possible values are: `none`, `shift`, `swapRequest`, `userShiftPreferences`, `openShift`, `openShiftRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`, `timeOff`, `timeOffRequest`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason` , `timeOff` , `timeOffRequest`.| |url|String| Workforce Integration URL for callbacks from the Shifts service.| diff --git a/api-reference/v1.0/resources/changetrackedentity.md b/api-reference/v1.0/resources/changetrackedentity.md index 44ced58e959..68592a07cdf 100644 --- a/api-reference/v1.0/resources/changetrackedentity.md +++ b/api-reference/v1.0/resources/changetrackedentity.md @@ -2,7 +2,8 @@ title: "changeTrackedEntity resource type" description: "Represents an entity to track changes made to any supported Shifts resource" ms.localizationpriority: medium -author: "akumar39" +ms.date: 11/21/2024 +author: "victorcheng" ms.subservice: "teams" doc_type: "resourcePageType" --- diff --git a/api-reference/v1.0/resources/enums.md b/api-reference/v1.0/resources/enums.md index 739222e9f02..d942c2ae39d 100644 --- a/api-reference/v1.0/resources/enums.md +++ b/api-reference/v1.0/resources/enums.md @@ -3,6 +3,7 @@ title: "Enum values" description: "Microsoft Graph enumeration values." ms.localizationpriority: medium ms.subservice: "non-product-specific" +ms.date: 11/21/2024 author: "MSGraphDocsvTeam" doc_type: enumPageType --- diff --git a/api-reference/v1.0/resources/openshift.md b/api-reference/v1.0/resources/openshift.md index a001b691f1a..cc3a7687560 100644 --- a/api-reference/v1.0/resources/openshift.md +++ b/api-reference/v1.0/resources/openshift.md @@ -2,7 +2,8 @@ title: "openShift resource type" description: "Represents an unassigned open shift in a schedule." ms.localizationpriority: medium -author: "akumar39" +ms.date: 11/21/2024 +author: "victorcheng" ms.subservice: "teams" doc_type: "resourcePageType" --- @@ -23,7 +24,7 @@ Represents an unassigned, open shift in a [schedule](../resources/schedule.md). | [Get](../api/openshift-get.md) | [openShift](openshift.md) | Read the properties and relationships of an **openShift** object. | | [Update](../api/openshift-update.md) | [openShift](openshift.md) | Update an **openShift** object. | | [Delete](../api/openshift-delete.md) | None | Delete an **openShift** object. | -| [stageForDeletion](../api/changetrackedentity-stagefordeletion.md) | None | Stage the deletion of an [openShift](../resources/openshift.md) instance in a [schedule](../resources/schedule.md) in draft mode. | | +| [stageForDeletion](../api/changetrackedentity-stagefordeletion.md) | None | Stage the deletion of an [openShift](../resources/openshift.md) instance in a [schedule](../resources/schedule.md) in draft mode. | ## Properties diff --git a/api-reference/v1.0/resources/shift.md b/api-reference/v1.0/resources/shift.md index ea66bf59869..9a041d4f197 100644 --- a/api-reference/v1.0/resources/shift.md +++ b/api-reference/v1.0/resources/shift.md @@ -1,7 +1,8 @@ --- title: "shift resource type" description: "Represents a unit of scheduled work in the schedule." -author: "akumar39" +ms.date: 11/21/2024 +author: "victorcheng" ms.localizationpriority: medium ms.subservice: "teams" doc_type: resourcePageType diff --git a/api-reference/v1.0/resources/timeoff.md b/api-reference/v1.0/resources/timeoff.md index a43ede5fe45..fab78b8aa2b 100644 --- a/api-reference/v1.0/resources/timeoff.md +++ b/api-reference/v1.0/resources/timeoff.md @@ -1,7 +1,8 @@ --- title: "timeOff resource type" description: "Represents a unit of non-work in a schedule." -author: "akumar39" +ms.date: 11/21/2024 +author: "victorcheng" ms.localizationpriority: medium ms.subservice: "teams" doc_type: resourcePageType_ diff --git a/api-reference/v1.0/resources/workforceintegration.md b/api-reference/v1.0/resources/workforceintegration.md index dced3dafb54..0eff6f39e10 100644 --- a/api-reference/v1.0/resources/workforceintegration.md +++ b/api-reference/v1.0/resources/workforceintegration.md @@ -2,7 +2,8 @@ title: "workforceIntegration resource type" description: "An instance of a workforce integration with shifts." ms.localizationpriority: medium -author: "akumar39" +ms.date: 11/21/2024 +author: "victorcheng" ms.subservice: "teams" doc_type: "resourcePageType" --- From f2e19f59562d78111a375f20f9984106f4e33c09 Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Thu, 21 Nov 2024 11:32:53 -0800 Subject: [PATCH 036/144] remove beta disclaimer --- .../v1.0/api/changetrackedentity-stagefordeletion.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md b/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md index 359bd3c6594..b3cc029be8a 100644 --- a/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md +++ b/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md @@ -10,10 +10,6 @@ doc_type: apiPageType # changeTrackedEntity: stageForDeletion -Namespace: microsoft.graph - -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - Stage the deletion of an [openShift](../resources/openshift.md), [shift](../resources/shift.md), or [timeOff](../resources/timeoff.md) instance in a [schedule](../resources/schedule.md) in draft mode. Draft changes are only visible to managers. Team members aren't sent notification for draft changes. The deletion is finalized when the schedule is [shared](../api/schedule-share.md). From c959661c388397292ac9a432d083e4051c9d0a46 Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Thu, 21 Nov 2024 14:20:04 -0800 Subject: [PATCH 037/144] fix warning --- api-reference/beta/api/openshift-post.md | 1 + api-reference/v1.0/api/openshift-update.md | 3 ++- api-reference/v1.0/api/shift-put.md | 1 + api-reference/v1.0/api/timeoff-put.md | 4 +++- api-reference/v1.0/api/workforceintegration-post.md | 3 ++- api-reference/v1.0/api/workforceintegration-update.md | 5 ++++- 6 files changed, 13 insertions(+), 4 deletions(-) diff --git a/api-reference/beta/api/openshift-post.md b/api-reference/beta/api/openshift-post.md index 11026e7cd0b..9f1fd427c74 100644 --- a/api-reference/beta/api/openshift-post.md +++ b/api-reference/beta/api/openshift-post.md @@ -57,6 +57,7 @@ The following example shows a request. ```http diff --git a/api-reference/v1.0/api/openshift-update.md b/api-reference/v1.0/api/openshift-update.md index 6697c0197ff..b88f86071a0 100644 --- a/api-reference/v1.0/api/openshift-update.md +++ b/api-reference/v1.0/api/openshift-update.md @@ -69,7 +69,7 @@ The following example shows a request. }--> ```http -PATCH https://graph.microsoft.com/v1.0/team/schedule/openShifts/{openShiftId} +PUT https://graph.microsoft.com/beta/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/openShifts/OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8 Content-Type: application/json { @@ -108,6 +108,7 @@ The following example shows the response. ```http HTTP/1.1 204 No Content +{} ``` - + "blockType": "ignored" +}--> ```http HTTP/1.1 204 No Content -{} ``` - - - diff --git a/api-reference/v1.0/api/shift-put.md b/api-reference/v1.0/api/shift-put.md index 4119f7cd7b5..2a6d57eedac 100644 --- a/api-reference/v1.0/api/shift-put.md +++ b/api-reference/v1.0/api/shift-put.md @@ -97,27 +97,8 @@ The following example shows the response. >**Note:** The response object shown here might be shortened for readability. - + "blockType": "ignored" +}--> ```http HTTP/1.1 204 No Content -{} -``` - - - - +``` \ No newline at end of file diff --git a/api-reference/v1.0/api/timeoff-put.md b/api-reference/v1.0/api/timeoff-put.md index 8a4f8a296a4..954da06c874 100644 --- a/api-reference/v1.0/api/timeoff-put.md +++ b/api-reference/v1.0/api/timeoff-put.md @@ -98,27 +98,9 @@ The following example shows the response. >**Note:** The response object shown here might be shortened for readability. - + "blockType": "ignored" +}--> ```http HTTP/1.1 204 No Content -{} ``` - - - diff --git a/api-reference/v1.0/api/workforceintegration-update.md b/api-reference/v1.0/api/workforceintegration-update.md index 898f272e17c..da89eef202c 100644 --- a/api-reference/v1.0/api/workforceintegration-update.md +++ b/api-reference/v1.0/api/workforceintegration-update.md @@ -3,7 +3,7 @@ title: "Update workforceIntegration" description: "Update the properties of a workforceIntegration object." ms.localizationpriority: medium ms.date: 11/21/2024 -author: "victorcheng" +author: "akumar39" ms.subservice: "teams" doc_type: "apiPageType" --- From 11804a09d1e26ddcdb5a9a1f79af908d4279e297 Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Thu, 21 Nov 2024 15:05:57 -0800 Subject: [PATCH 039/144] update log --- changelog/Microsoft.Teams.Shifts.json | 25 ++++++++++++------------- 1 file changed, 12 insertions(+), 13 deletions(-) diff --git a/changelog/Microsoft.Teams.Shifts.json b/changelog/Microsoft.Teams.Shifts.json index 38c0d8a3517..bd733cb12d5 100644 --- a/changelog/Microsoft.Teams.Shifts.json +++ b/changelog/Microsoft.Teams.Shifts.json @@ -655,7 +655,7 @@ { "ChangeList": [ { - "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "Id": "3292bcc6-e31c-4e8e-a090-63b6f13eec0c", "ApiChange": "Enumeration", "ChangedApiName": "eligibilityFilteringEnabledEntities", "ChangeType": "Addition", @@ -663,7 +663,7 @@ "Target": "eligibilityFilteringEnabledEntities" }, { - "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "Id": "3292bcc6-e31c-4e8e-a090-63b6f13eec0c", "ApiChange": "Member", "ChangedApiName": "timeOffReason", "ChangeType": "Addition", @@ -671,7 +671,7 @@ "Target": "workforceIntegrationSupportedEntities" }, { - "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "Id": "3292bcc6-e31c-4e8e-a090-63b6f13eec0c", "ApiChange": "Member", "ChangedApiName": "timeOff", "ChangeType": "Addition", @@ -679,7 +679,7 @@ "Target": "workforceIntegrationSupportedEntities" }, { - "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "Id": "3292bcc6-e31c-4e8e-a090-63b6f13eec0c", "ApiChange": "Member", "ChangedApiName": "timeOffRequest", "ChangeType": "Addition", @@ -687,7 +687,7 @@ "Target": "workforceIntegrationSupportedEntities" }, { - "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "Id": "3292bcc6-e31c-4e8e-a090-63b6f13eec0c", "ApiChange": "Property", "ChangedApiName": "isStagedForDeletion", "ChangeType": "Addition", @@ -695,7 +695,7 @@ "Target": "openShift" }, { - "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "Id": "3292bcc6-e31c-4e8e-a090-63b6f13eec0c", "ApiChange": "Property", "ChangedApiName": "isStagedForDeletion", "ChangeType": "Addition", @@ -703,7 +703,7 @@ "Target": "shift" }, { - "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "Id": "3292bcc6-e31c-4e8e-a090-63b6f13eec0c", "ApiChange": "Property", "ChangedApiName": "isStagedForDeletion", "ChangeType": "Addition", @@ -711,7 +711,7 @@ "Target": "timeOff" }, { - "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "Id": "3292bcc6-e31c-4e8e-a090-63b6f13eec0c", "ApiChange": "Property", "ChangedApiName": "eligibilityFilteringEnabledEntities", "ChangeType": "Addition", @@ -719,7 +719,7 @@ "Target": "workforceIntegration" }, { - "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", + "Id": "3292bcc6-e31c-4e8e-a090-63b6f13eec0c", "ApiChange": "Method", "ChangedApiName": "stageForDeletion", "ChangeType": "Addition", @@ -727,13 +727,12 @@ "Target": "changeTrackedEntity" } ], - "Id": "5b726d7b-c50a-4bdc-a056-8c49cb3edbdb", - "Cloud": "Review", + "Id": "3292bcc6-e31c-4e8e-a090-63b6f13eec0c", + "Cloud": "Prod", "Version": "v1.0", - "CreatedDateTime": "2024-11-21T06:19:39.9488203Z", + "CreatedDateTime": "2024-11-21T22:51:07.7910122Z", "WorkloadArea": "Teamwork", "SubArea": "" } - ] } \ No newline at end of file From 4de593bebbbe1f58662a051104b769d6adbd67e4 Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Thu, 21 Nov 2024 15:21:37 -0800 Subject: [PATCH 040/144] fix --- api-reference/v1.0/api/openshift-update.md | 12 +++++++++--- api-reference/v1.0/api/shift-put.md | 14 +++++++++++--- api-reference/v1.0/api/timeoff-put.md | 14 ++++++++++---- .../v1.0/api/workforceintegration-post.md | 3 +-- .../v1.0/api/workforceintegration-update.md | 1 - 5 files changed, 31 insertions(+), 13 deletions(-) diff --git a/api-reference/v1.0/api/openshift-update.md b/api-reference/v1.0/api/openshift-update.md index 1aa55939a6c..a3a2c756a6a 100644 --- a/api-reference/v1.0/api/openshift-update.md +++ b/api-reference/v1.0/api/openshift-update.md @@ -1,7 +1,6 @@ --- title: "Update openShift" description: "Update the properties of an openShift object." -ms.date: 11/12/2024 ms.localizationpriority: medium author: "akumar39" ms.subservice: "teams" @@ -100,9 +99,16 @@ The following example shows the response. > **Note:** The response object shown here might be shortened for readability. + "blockType": "response", + "truncated": true +} --> ```http HTTP/1.1 204 No Content ``` + + diff --git a/api-reference/v1.0/api/shift-put.md b/api-reference/v1.0/api/shift-put.md index 2a6d57eedac..69450576b68 100644 --- a/api-reference/v1.0/api/shift-put.md +++ b/api-reference/v1.0/api/shift-put.md @@ -97,8 +97,16 @@ The following example shows the response. >**Note:** The response object shown here might be shortened for readability. + "blockType": "response", + "truncated": true +} --> ```http HTTP/1.1 204 No Content -``` \ No newline at end of file +``` + + + diff --git a/api-reference/v1.0/api/timeoff-put.md b/api-reference/v1.0/api/timeoff-put.md index 954da06c874..ea1d2bcae35 100644 --- a/api-reference/v1.0/api/timeoff-put.md +++ b/api-reference/v1.0/api/timeoff-put.md @@ -1,8 +1,7 @@ --- title: "Replace timeOff" description: "Replace an existing timeOff object." -ms.date: 11/21/2024 -author: "victorcheng" +author: "akumar39" ms.localizationpriority: medium ms.subservice: "teams" doc_type: apiPageType @@ -98,9 +97,16 @@ The following example shows the response. >**Note:** The response object shown here might be shortened for readability. + "blockType": "response", + "truncated": true +} --> ```http HTTP/1.1 204 No Content ``` + + diff --git a/api-reference/v1.0/api/workforceintegration-post.md b/api-reference/v1.0/api/workforceintegration-post.md index d493c05c938..861afac9ba8 100644 --- a/api-reference/v1.0/api/workforceintegration-post.md +++ b/api-reference/v1.0/api/workforceintegration-post.md @@ -2,8 +2,7 @@ title: "Create workforceIntegration" description: "Create a new workforceIntegration object." ms.localizationpriority: medium -ms.date: 11/21/2024 -author: "victorcheng" +author: "akumar39" ms.subservice: "teams" doc_type: "apiPageType" --- diff --git a/api-reference/v1.0/api/workforceintegration-update.md b/api-reference/v1.0/api/workforceintegration-update.md index da89eef202c..d8457d7638b 100644 --- a/api-reference/v1.0/api/workforceintegration-update.md +++ b/api-reference/v1.0/api/workforceintegration-update.md @@ -2,7 +2,6 @@ title: "Update workforceIntegration" description: "Update the properties of a workforceIntegration object." ms.localizationpriority: medium -ms.date: 11/21/2024 author: "akumar39" ms.subservice: "teams" doc_type: "apiPageType" From ff0c9b9200be93d19740b83232cd2d7f3108c909 Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Thu, 21 Nov 2024 15:28:00 -0800 Subject: [PATCH 041/144] fix --- api-reference/v1.0/api/openshift-post.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/openshift-post.md b/api-reference/v1.0/api/openshift-post.md index 7a0f61c5136..feb104ebfd5 100644 --- a/api-reference/v1.0/api/openshift-post.md +++ b/api-reference/v1.0/api/openshift-post.md @@ -1,8 +1,8 @@ --- title: "Create openShift" description: "Create an instance of openShift object." -author: "akumar39" ms.localizationpriority: medium +author: "akumar39" ms.subservice: "teams" doc_type: "apiPageType" --- From a60b2e0e568d3cd7dd91a90b27aae27477bb711d Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Thu, 21 Nov 2024 15:39:00 -0800 Subject: [PATCH 042/144] fix openshift-post --- api-reference/v1.0/api/openshift-post.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/openshift-post.md b/api-reference/v1.0/api/openshift-post.md index feb104ebfd5..fe3aae07190 100644 --- a/api-reference/v1.0/api/openshift-post.md +++ b/api-reference/v1.0/api/openshift-post.md @@ -62,7 +62,9 @@ If successful, this method returns a `200 OK` response code and the created [ope The following example shows a request. # [HTTP](#tab/http) ```http From a899fc350a4c0308609a33ea2b2a9a93d78e209b Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Thu, 21 Nov 2024 15:49:30 -0800 Subject: [PATCH 043/144] fix --- api-reference/v1.0/api/openshift-post.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/api-reference/v1.0/api/openshift-post.md b/api-reference/v1.0/api/openshift-post.md index fe3aae07190..a0d251a6d1d 100644 --- a/api-reference/v1.0/api/openshift-post.md +++ b/api-reference/v1.0/api/openshift-post.md @@ -63,7 +63,7 @@ The following example shows a request. # [HTTP](#tab/http) @@ -75,11 +75,11 @@ Content-type: application/json { "schedulingGroupId": "TAG_4ab7d329-1f7e-4eaf-ba93-63f1ff3f3c4a", "sharedOpenShift": { - "displayName": null, + "displayName": "Dayshift", "startDateTime": "2024-11-04T20:00:00Z", "endDateTime": "2024-11-04T21:00:00Z", "theme": "blue", - "notes": null, + "notes": "InventoryManagement", "openSlotCount": 1, "activities": [] }, @@ -150,8 +150,8 @@ Content-Type: application/json "application": null, "device": null, "user": { - "id": "aa162a04-bec6-4b81-ba99-96caa7b2b24d", - "displayName": "victorcheng", + "id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8", + "displayName": "John Doe", "userIdentityType": "aadUser", "tenantId": null } From d158c0e6f911856b228b95fc88e34dcfb8405f74 Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Thu, 21 Nov 2024 16:12:39 -0800 Subject: [PATCH 044/144] fix again --- api-reference/beta/api/openshift-post.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/openshift-post.md b/api-reference/beta/api/openshift-post.md index 9f1fd427c74..cd8b96c3a7c 100644 --- a/api-reference/beta/api/openshift-post.md +++ b/api-reference/beta/api/openshift-post.md @@ -1,6 +1,6 @@ --- title: "Create openShift" -description: "Create an instance of openshift object." +description: "Create an instance of openShift object." ms.localizationpriority: medium author: "akumar39" ms.subservice: "teams" From 0be6fb75045731a15c254c8b1d29dee81f35acb4 Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Thu, 21 Nov 2024 16:23:30 -0800 Subject: [PATCH 045/144] fix again --- api-reference/beta/api/openshift-post.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/openshift-post.md b/api-reference/beta/api/openshift-post.md index cd8b96c3a7c..6401c923db8 100644 --- a/api-reference/beta/api/openshift-post.md +++ b/api-reference/beta/api/openshift-post.md @@ -56,7 +56,7 @@ The following example shows a request. # [HTTP](#tab/http) From ddc74fb796a44ca6672c091ab176cf44aed5bbd7 Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Fri, 22 Nov 2024 11:31:36 -0800 Subject: [PATCH 046/144] fixed comment by doc team --- .../changetrackedentity-stagefordeletion.md | 12 +-- api-reference/v1.0/api/openshift-post.md | 4 +- api-reference/v1.0/api/openshift-update.md | 4 +- .../v1.0/api/schedule-post-timesoff.md | 4 +- api-reference/v1.0/api/shift-put.md | 4 +- api-reference/v1.0/api/timeoff-put.md | 4 +- ...eintegration-from-teamwork-cli-snippets.md | 34 ------- .../cli/openshiftpost-cli-snippets.md | 34 ------- .../cli/schedule-post-shifts-cli-snippets.md | 31 ------- .../snippets/cli/timeoff-post-cli-snippets.md | 40 --------- ...pdate-workforceintegration-cli-snippets.md | 34 ------- ...tegration-from-teamwork-csharp-snippets.md | 31 ------- .../csharp/openshiftpost-csharp-snippets.md | 46 ---------- .../schedule-post-shifts-csharp-snippets.md | 61 ------------- .../csharp/timeoff-post-csharp-snippets.md | 36 -------- ...te-workforceintegration-csharp-snippets.md | 31 ------- ...ceintegration-from-teamwork-go-snippets.md | 41 --------- .../snippets/go/openshiftpost-go-snippets.md | 71 --------------- .../go/schedule-post-shifts-go-snippets.md | 90 ------------------- .../snippets/go/timeoff-post-go-snippets.md | 48 ---------- ...update-workforceintegration-go-snippets.md | 41 --------- ...integration-from-teamwork-java-snippets.md | 25 ------ .../java/openshiftpost-java-snippets.md | 41 --------- .../schedule-post-shifts-java-snippets.md | 58 ------------ .../java/timeoff-post-java-snippets.md | 33 ------- ...date-workforceintegration-java-snippets.md | 25 ------ ...ation-from-teamwork-javascript-snippets.md | 29 ------ .../openshiftpost-javascript-snippets.md | 39 -------- ...iftstagefordeletion-javascript-snippets.md | 16 ---- ...chedule-post-shifts-javascript-snippets.md | 38 -------- .../shift-put-javascript-snippets.md | 38 -------- ...iftstagefordeletion-javascript-snippets.md | 17 ---- .../timeoff-post-javascript-snippets.md | 33 ------- ...offstagefordeletion-javascript-snippets.md | 17 ---- ...orkforceintegration-javascript-snippets.md | 29 ------ ...eintegration-from-teamwork-php-snippets.md | 31 ------- .../php/openshiftpost-php-snippets.md | 50 ----------- .../php/schedule-post-shifts-php-snippets.md | 56 ------------ .../snippets/php/timeoff-post-php-snippets.md | 34 ------- ...pdate-workforceintegration-php-snippets.md | 31 ------- ...ation-from-teamwork-powershell-snippets.md | 24 ----- .../openshiftpost-powershell-snippets.md | 34 ------- ...chedule-post-shifts-powershell-snippets.md | 49 ---------- .../timeoff-post-powershell-snippets.md | 28 ------ ...orkforceintegration-powershell-snippets.md | 24 ----- ...tegration-from-teamwork-python-snippets.md | 30 ------- .../python/openshiftpost-python-snippets.md | 48 ---------- .../schedule-post-shifts-python-snippets.md | 55 ------------ .../python/timeoff-post-python-snippets.md | 33 ------- ...te-workforceintegration-python-snippets.md | 30 ------- 50 files changed, 16 insertions(+), 1680 deletions(-) delete mode 100644 api-reference/v1.0/includes/snippets/cli/create-workforceintegration-from-teamwork-cli-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/cli/openshiftpost-cli-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/cli/schedule-post-shifts-cli-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/cli/timeoff-post-cli-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/cli/update-workforceintegration-cli-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/csharp/create-workforceintegration-from-teamwork-csharp-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/csharp/openshiftpost-csharp-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/csharp/schedule-post-shifts-csharp-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/csharp/timeoff-post-csharp-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/csharp/update-workforceintegration-csharp-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/go/create-workforceintegration-from-teamwork-go-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/go/openshiftpost-go-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/go/schedule-post-shifts-go-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/go/timeoff-post-go-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/go/update-workforceintegration-go-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/java/create-workforceintegration-from-teamwork-java-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/java/openshiftpost-java-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/java/schedule-post-shifts-java-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/java/timeoff-post-java-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/java/update-workforceintegration-java-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/javascript/create-workforceintegration-from-teamwork-javascript-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/javascript/openshiftpost-javascript-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/javascript/openshiftstagefordeletion-javascript-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/javascript/schedule-post-shifts-javascript-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/javascript/shift-put-javascript-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/javascript/shiftstagefordeletion-javascript-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/javascript/timeoff-post-javascript-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/javascript/timeoffstagefordeletion-javascript-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/javascript/update-workforceintegration-javascript-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/php/create-workforceintegration-from-teamwork-php-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/php/openshiftpost-php-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/php/schedule-post-shifts-php-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/php/timeoff-post-php-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/php/update-workforceintegration-php-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/powershell/create-workforceintegration-from-teamwork-powershell-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/powershell/openshiftpost-powershell-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/powershell/schedule-post-shifts-powershell-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/powershell/timeoff-post-powershell-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/powershell/update-workforceintegration-powershell-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/python/create-workforceintegration-from-teamwork-python-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/python/openshiftpost-python-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/python/schedule-post-shifts-python-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/python/timeoff-post-python-snippets.md delete mode 100644 api-reference/v1.0/includes/snippets/python/update-workforceintegration-python-snippets.md diff --git a/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md b/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md index b3cc029be8a..3faca806aef 100644 --- a/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md +++ b/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md @@ -79,7 +79,7 @@ The following example shows how to stage the deletion of an **openShift** in a * The following example shows a request. -# [HTTP](#tab/http) +# [HTTP] ``` http -POST https://graph.microsoft.com/beta/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/openShifts/OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion +POST https://graph.microsoft.com/v1.0/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/openShifts/OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion ``` #### Response @@ -120,7 +118,7 @@ The following example shows a request. } --> ``` http -POST https://graph.microsoft.com/beta/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/shifts/SHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion +POST https://graph.microsoft.com/v1.0/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/shifts/SHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion ``` #### Response @@ -151,7 +149,7 @@ The following example shows a request. } --> ``` http -POST https://graph.microsoft.com/beta/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/timesOff/SHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion +POST https://graph.microsoft.com/v1.0/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/timesOff/SHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion ``` #### Response From 5d34e09440ca7a5a8110e0506fb2078bdaaf0a65 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Sat, 30 Nov 2024 07:52:25 +0100 Subject: [PATCH 072/144] Update openshift-post.md --- api-reference/beta/api/openshift-post.md | 1 + 1 file changed, 1 insertion(+) diff --git a/api-reference/beta/api/openshift-post.md b/api-reference/beta/api/openshift-post.md index 6401c923db8..0c1b0c1fe74 100644 --- a/api-reference/beta/api/openshift-post.md +++ b/api-reference/beta/api/openshift-post.md @@ -5,6 +5,7 @@ ms.localizationpriority: medium author: "akumar39" ms.subservice: "teams" doc_type: "apiPageType" +ms.date: 11/30/2024 --- # Create openShift From e1016808eb39f1eba661bf64d24ac0846cee06ab Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Sat, 30 Nov 2024 07:52:43 +0100 Subject: [PATCH 073/144] Update changetrackedentity-stagefordeletion.md --- api-reference/v1.0/api/changetrackedentity-stagefordeletion.md | 1 + 1 file changed, 1 insertion(+) diff --git a/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md b/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md index ba1a8a0af2c..5dd1d814aa9 100644 --- a/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md +++ b/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md @@ -5,6 +5,7 @@ author: "raulfernandes" ms.localizationpriority: medium ms.subservice: "teams" doc_type: apiPageType +ms.date: 11/30/2024 --- # changeTrackedEntity: stageForDeletion From fe9ba70ba1aa1c162fce31f471f42ab43cfc08f8 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Sat, 30 Nov 2024 07:57:33 +0100 Subject: [PATCH 074/144] Update changetrackedentity-stagefordeletion-permissions.md --- .../changetrackedentity-stagefordeletion-permissions.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/api-reference/v1.0/includes/permissions/changetrackedentity-stagefordeletion-permissions.md b/api-reference/v1.0/includes/permissions/changetrackedentity-stagefordeletion-permissions.md index 47d106e40f4..15a4f7f8ccf 100644 --- a/api-reference/v1.0/includes/permissions/changetrackedentity-stagefordeletion-permissions.md +++ b/api-reference/v1.0/includes/permissions/changetrackedentity-stagefordeletion-permissions.md @@ -1,6 +1,11 @@ +--- +description: "Automatically generated file. DO NOT MODIFY" +ms.topic: include +ms.localizationpriority: medium +--- + |Permission type|Least privileged permissions|Higher privileged permissions| |:---|:---|:---| |Delegated (work or school account)|Schedule.ReadWrite.All|Group.ReadWrite.All| |Delegated (personal Microsoft account)|Not supported.|Not supported.| |Application|Schedule.ReadWrite.All|Not available.| - From 11e52bc0459b4b2eb7820d836941c54b25a39aa5 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Sat, 30 Nov 2024 07:59:17 +0100 Subject: [PATCH 075/144] Update openshift-post.md --- api-reference/beta/api/openshift-post.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/openshift-post.md b/api-reference/beta/api/openshift-post.md index 0c1b0c1fe74..33834e9a22c 100644 --- a/api-reference/beta/api/openshift-post.md +++ b/api-reference/beta/api/openshift-post.md @@ -14,7 +14,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Create an instance of an [openshift](../resources/openshift.md) object. +Create an instance of an [openShift](../resources/openshift.md) object. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] From ac92b4e4599fe1666648425b4d796bb6c65159e1 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Sat, 30 Nov 2024 08:00:35 +0100 Subject: [PATCH 076/144] Update changetrackedentity-stagefordeletion.md --- api-reference/v1.0/api/changetrackedentity-stagefordeletion.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md b/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md index 5dd1d814aa9..59bdbb693eb 100644 --- a/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md +++ b/api-reference/v1.0/api/changetrackedentity-stagefordeletion.md @@ -18,7 +18,7 @@ Draft changes are only visible to managers. Team members aren't sent notificatio ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +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](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ```http -PUT https://graph.microsoft.com/beta/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/openShifts/OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8 +PUT https://graph.microsoft.com/v1.0/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/openShifts/OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8 Content-Type: application/json { - "schedulingGroupId": "TAG_4ab7d329-1f7e-4eaf-ba93-63f1ff3f3c4a", - "sharedOpenShift": { - "displayName": null, - "startDateTime": "2024-11-04T20:00:00Z", - "endDateTime": "2024-11-04T21:00:00Z", - "theme": "blue", - "notes": null, - "openSlotCount": 1, - "activities": [] - }, - "draftTimeOff": null, - "isStagedForDeletion": false + "schedulingGroupId": "TAG_4ab7d329-1f7e-4eaf-ba93-63f1ff3f3c4a", + "sharedOpenShift": { + "displayName": null, + "startDateTime": "2024-11-04T20:00:00Z", + "endDateTime": "2024-11-04T21:00:00Z", + "theme": "blue", + "notes": null, + "openSlotCount": 1, + "activities": [] + }, + "draftTimeOff": null, + "isStagedForDeletion": false } ``` -# [JavaScript](#tab/javascript) -[!INCLUDE [sample-code](../includes/snippets/javascript/update-openshift-javascript-snippets.md)] -[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] - ---- - ### Response The following example shows the response. -> **Note:** The response object shown here might be shortened for readability. ```json From 3bd278cc69c6106b8d4104cbede7b8332be3ad51 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Sat, 30 Nov 2024 21:27:55 +0100 Subject: [PATCH 105/144] Update openshiftitem.md --- api-reference/v1.0/resources/openshiftitem.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/api-reference/v1.0/resources/openshiftitem.md b/api-reference/v1.0/resources/openshiftitem.md index abd137da266..26efbe0a068 100644 --- a/api-reference/v1.0/resources/openshiftitem.md +++ b/api-reference/v1.0/resources/openshiftitem.md @@ -14,6 +14,8 @@ Namespace: microsoft.graph Represents a single count of an [openShift](../resources/openshift.md). +Inherits from [shiftItem](../resources/shiftitem.md). + ## Properties | Property | Type | Description | From b023f530becec60b104e2ddfaf13d785d37e0db1 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Sat, 30 Nov 2024 21:29:40 +0100 Subject: [PATCH 106/144] Update openshift.md --- api-reference/v1.0/resources/openshift.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/api-reference/v1.0/resources/openshift.md b/api-reference/v1.0/resources/openshift.md index efadb3ba3d8..ae2770d78c2 100644 --- a/api-reference/v1.0/resources/openshift.md +++ b/api-reference/v1.0/resources/openshift.md @@ -12,9 +12,10 @@ doc_type: "resourcePageType" Namespace: microsoft.graph - Represents an unassigned, open shift in a [schedule](../resources/schedule.md). +Inherits from [changeTrackedEntity](../resources/changetrackedentity.md). + ## Methods | Method | Return Type | Description | @@ -52,7 +53,8 @@ The following JSON representation shows the resource type. "optionalProperties": [ ], - "@odata.type": "microsoft.graph.openShift" + "@odata.type": "microsoft.graph.openShift", + "baseType": "microsoft.graph.changeTrackedEntity" }--> ```json From 0558a1e9a92c6364079cd38b9c77400851eb04eb Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Sat, 30 Nov 2024 21:37:25 +0100 Subject: [PATCH 107/144] Update whats-new-earlier.md --- concepts/whats-new-earlier.md | 131 +++++++++++++++++++++++++++++++++- 1 file changed, 129 insertions(+), 2 deletions(-) diff --git a/concepts/whats-new-earlier.md b/concepts/whats-new-earlier.md index 820c2f38f6a..2d74b13ea8e 100644 --- a/concepts/whats-new-earlier.md +++ b/concepts/whats-new-earlier.md @@ -10,6 +10,133 @@ ms.date: 11/07/2024 Find information about previous additions and updates to Microsoft Graph APIs, documentation, SDKs, and other resources. +## October 2024: New and generally available + +### Backup storage + +Updated the endpoints of the following methods: +- [List driveProtectionUnits](/graph/api/backuprestoreroot-list-driveprotectionunits) +- [List mailboxProtectionUnits](/graph/api/backuprestoreroot-list-mailboxprotectionunits) +- [List siteProtectionUnits](/graph/api/backuprestoreroot-list-siteprotectionunits) + +### Change notifications + +Enabled the `$notifyOnUserSpecificProperties` query parameter as a value of the **resource** property in the [subscription](/graph/api/resources/subscription?view=graph-rest-beta&preserve-view=true) resource. You can use the [notifyOnUserSpecificProperties](/graph/teams-changenotifications-chat#notification-payloads-for-user-specific-properties) parameter when you subscribe to [notifications in a particular chat](/graph/teams-changenotifications-chat#subscribe-to-changes-in-a-particular-chat). + +### Identity and access | Directory management + +- [Get](/graph/api/domain-get-rootdomain) the root domain of a subdomain. +- Added recommendations to use unified RBAC APIs in [unifiedRoleDefinition](/graph/api/resources/unifiedroledefinition) instead of [directoryRole](/graph/api/resources/directoryrole) and [directoryRoleTemplate](/graph/api/resources/directoryroletemplate). +- Use the **membershipRule** property on [administrativeUnit](/graph/api/resources/administrativeunit) to get or set the dynamic membership rule for an administrative unit. +- Use the **membershipRuleProcessingState** property on [administrativeUnit](/graph/api/resources/administrativeunit) to indicate whether the dynamic membership rule is actively processed. +- Use the **membershipType** property on [administrativeUnit](/graph/api/resources/administrativeunit) to get or set the membership type for an administrative unit. + +### Security | eDiscovery + +- Enabled the deletion of Exchange mailbox items in the [ediscoverySearch: purgeData](/graph/api/security-ediscoverysearch-purgedata) method. +- Deleted the `permanentlyDeleted` member from the **purgeType** enumeration in favor of the `permanentlyDelete` member. +- Export [results](/graph/api/security-ediscoverysearch-exportresult) and a [report](/graph/api/security-ediscoverysearch-exportreport) from an [ediscoverySearch](/graph/api/resources/security-ediscoverysearch). +- Legal holds are holds that are tied to an eDiscovery case. To learn more about a legal hold policy and its supported methods, see [ediscoveryHoldPolicy](/graph/api/resources/security-ediscoveryholdpolicy). + +### Teamwork and communications | Apps + +Use the **clientAppId** property on [teamsAppAuthorization](/graph/api/resources/teamsappauthorization) to get the registration ID of the Microsoft Entra app ID associated with an [app](/graph/api/resources/teamsapp) in the Microsoft Teams app catalog. + +### Teamwork and communications | Calls and online meetings + +Use the **isDeltaRosterEnabled** property on [incomingCallOptions](/graph/api/resources/incomingcalloptions) and [outgoingCallOptions](/graph/api/resources/outgoingcalloptions) to indicate whether delta roster is enabled for a call. + +### Teamwork and communications | Messaging + +- Updated the [chatMessage: delta](/graph/api/chatmessage-delta) method to use a new endpoint that gets the list of delta messages from all chats in which a user is a participant, including one-on-one chats, group chats, and meeting chats. +- Use the **reactionContentUrl** property on [chatMessageReaction](/graph/api/resources/chatmessagereaction) to represent the hosted content URL for a custom reaction in a [chatMessage](/graph/api/resources/chatmessage). +- Use the `` tag on the **content** property of the [itemBody](/graph/api/resources/itembody) resource to represent custom emojis in the message body in a [chatMessage](/graph/api/resources/chatmessage). +- Use the **displayName** property on [chatMessageReaction](/graph/api/resources/chatmessagereaction) to represent the reaction name in a [chatMessage](/graph/api/resources/chatmessage). + +## October 2024: New in preview only + +### Backup storage + +Added new endpoints for bulk addition of protection units into a protection policy: +- [Create siteProtectionUnitsBulkAdditionJob](/graph/api/siteprotectionunitsbulkadditionjobs-post?view=graph-rest-beta&preserve-view=true) +- [List siteProtectionUnitsBulkAdditionJobs](/graph/api/sharepointprotectionpolicy-list-siteprotectionunitsbulkadditionjobs?view=graph-rest-beta&preserve-view=true) +- [Get siteProtectionUnitsBulkAdditionJob](/graph/api/siteprotectionunitsbulkadditionjobs-get?view=graph-rest-beta&preserve-view=true) + +- [Create mailboxProtectionUnitsBulkAdditionJob](/graph/api/mailboxprotectionunitsbulkadditionjobs-post?view=graph-rest-beta&preserve-view=true) +- [List mailboxProtectionUnitsBulkAdditionJobs](/graph/api/onedriveforbusinessprotectionpolicy-list-driveprotectionunitsbulkadditionjobs?view=graph-rest-beta&preserve-view=true) +- [Get mailboxProtectionUnitsBulkAdditionJob](/graph/api/mailboxprotectionunitsbulkadditionjobs-get?view=graph-rest-beta&preserve-view=true) + +- [Create driveProtectionUnitsBulkAdditionJob](/graph/api/driveprotectionunitsbulkadditionjobs-post?view=graph-rest-beta&preserve-view=true) +- [List driveProtectionUnitsBulkAdditionJobs](/graph/api/exchangeprotectionpolicy-list-mailboxprotectionunitsbulkadditionjobs?view=graph-rest-beta&preserve-view=true) +- [Get driveProtectionUnitsBulkAdditionJob](/graph/api/driveprotectionunitsbulkadditionjobs-get?view=graph-rest-beta&preserve-view=true) + +Updated the endpoints of the following methods: +- [List driveProtectionUnits](/graph/api/backuprestoreroot-list-driveprotectionunits?view=graph-rest-beta&preserve-view=true) +- [List mailboxProtectionUnits](/graph/api/backuprestoreroot-list-mailboxprotectionunits?view=graph-rest-beta&preserve-view=true) +- [List siteProtectionUnits](/graph/api/backuprestoreroot-list-siteprotectionunits?view=graph-rest-beta&preserve-view=true) + +### Device and app management | Cloud licensing + +- Use the new cloud licensing [usageRight](/graph/api/resources/cloudlicensing-usageright?view=graph-rest-beta&preserve-view=true) entity that is designed for client and workload license checks, with relationships structured to flow from the user or group to the **usageRight**. This new entity supports the following operations: + - [List usage rights for a group](/graph/api/cloudlicensing-groupcloudlicensing-list-usagerights?view=graph-rest-beta&preserve-view=true) + - [List usage rights for a user](/graph/api/cloudlicensing-usercloudlicensing-list-usagerights?view=graph-rest-beta&preserve-view=true) + - [Get usage rights for a group or user](/graph/api/cloudlicensing-usageright-get?view=graph-rest-beta&preserve-view=true) +- Use the **cloudLicensing** property on a [group](/graph/api/resources/group?view=graph-rest-beta&preserve-view=true) or [user](/graph/api/resources/user?view=graph-rest-beta&preserve-view=true) to get their relationships with cloud licensing resources. + +### Device and app management | Cloud PC + +- Enabled the `$select` query parameter for the [cloudPC: getProvisionedCloudPCs](/graph/api/cloudpc-getprovisionedcloudpcs?view=graph-rest-beta&preserve-view=true) method. +- Use the **notificationSetting** property on [cloudPcUserSetting](/graph/api/resources/cloudpcnotificationsetting?view=graph-rest-beta&preserve-view=true) to define the Cloud PC notification prompts for a Cloud PC user. +- Enabled the `cloudPcFrontlineBufferUsageScenario` member in the **alertRuleTemplate** enumeration. +- Enabled the `frontlineBufferUsageDuration` and `frontlineBufferUsageThreshold` members in the **ruleCondition** enumeration. + +### Identity and access | Directory management + +Get or update the [uxSetting](/graph/api/resources/uxsetting?view=graph-rest-beta&preserve-view=true) that restricts access to Microsoft Entra admin center to only administrators. + +### Identity and access | Identity and sign-in + +Enabled `suspiciousAPITraffic` as a supported value for the **riskEventType** property in the [servicePrincipalRiskDetection](/graph/api/resources/serviceprincipalriskdetection?view=graph-rest-beta&preserve-view=true) resource. You can retrieve this value when you use either the [List servicePrincipalRiskDetections](/graph/api/identityprotectionroot-list-serviceprincipalriskdetections?view=graph-rest-beta&preserve-view=true) or [Get servicePrincipalRiskDetection](/graph/api/serviceprincipalriskdetection-get?view=graph-rest-beta&preserve-view=true) APIs. + +### Reports | Identity and access reports + +The Microsoft Entra Health monitoring alerts APIs enable you to detect anomalous usage patterns in business-critical identity scenarios for your tenant and receive alert notifications. Use the operations of the [alert](/graph/api/resources/healthmonitoring-alert?view=graph-rest-beta&preserve-view=true) and [alertConfiguration](/graph/api/resources/healthmonitoring-alertconfiguration?view=graph-rest-beta&preserve-view=true) resources to retrieve and update alerts and alert configurations. For details, see the [related changelog section](https://developer.microsoft.com/graph/changelog/?search=277da918-3e81-499f-8803-2986a2c73123). + +### Security | eDiscovery + +- Enabled the deletion of Exchange mailbox items in the [ediscoverySearch: purgeData](/graph/api/security-ediscoverysearch-purgedata?view=graph-rest-beta&preserve-view=true) method. +- Deleted the `permanentlyDeleted` member from the **purgeType** enumeration in favor of the `permanentlyDelete` member. + +### Sites and lists + +Updated the endpoints of the following methods: +- [Get](/graph/api/pagetemplate-get?view=graph-rest-beta&preserve-view=true) +- [Update](/graph/api/pagetemplate-update?view=graph-rest-beta&preserve-view=true) +- [Delete](/graph/api/pagetemplate-delete?view=graph-rest-beta&preserve-view=true) + +### Teamwork and communications | Calls and online meetings + +- Use the **externalRegistrationInformation** property on [virtualEventRegistration](/graph/api/resources/virtualeventregistration?view=graph-rest-betaa&preserve-view=true) to get or set the external information for a virtual event registration. +- Use the following new methods for virtual events that are of the [virtualEventTownhall](/graph/api/resources/virtualeventtownhall?view=graph-rest-beta&preserve-view=true) type: + - [List](/graph/api/virtualeventsroot-list-townhalls?view=graph-rest-beta&preserve-view=true) all virtual event town halls created in a tenant. + - [Get](/graph/api/virtualeventtownhall-getbyuseridandrole?view=graph-rest-beta&preserve-view=true) the virtual event town halls where a specified user is an organizer or coorganizer. + - [Get](/graph/api/virtualeventtownhall-getbyuserrole?view=graph-rest-beta&preserve-view=true) the virtual event town halls where the signed-in user is an organizer or coorganizer. + +### Teamwork and communications | Messaging + +- Updated the [chatMessage: delta](/graph/api/chatmessage-delta?view=graph-rest-beta&preserve-view=true) method to use a new endpoint that gets the list of delta messages from all chats in which a user is a participant, including one-on-one chats, group chats, and meeting chats. +- [Get](/graph/api/chatmessage-get?view=graph-rest-beta&preserve-view=true#example-6-get-a-chat-message-with-a-forwarded-message) a chat message that has a forwarded message as an attachment. +- [Remove multiple members](/graph/api/conversationmember-remove?view=graph-rest-beta&preserve-view=true) from a [team](/graph/api/resources/team?view=graph-rest-beta&preserve-view=true) in a single request. + +### Users + +Changed the following on-premises synced properties of the [user](/graph/api/resources/user?view=graph-rest-beta&preserve-view=true) resource type that were read-only in Microsoft Graph to be updatable via Microsoft Graph: +- onPremisesDistinguishedName +- onPremisesDomainName +- onPremisesSamAccountName +- onPremisesSecurityIdentifier +- onPremisesUserPrincipalName + ## September 2024: New and generally available ### Change notifications @@ -810,8 +937,8 @@ Manage change notifications for virtual events using the [Create](/graph/api/sub ### Teamwork and communications | Shift management -- Get all [openShift](/graph/api/resources/openshift) objects across all teams a user is a direct member of, removing the need to specify a team ID in the request. For more information, see [team: getOpenShifts](/graph/api/team-getopenshifts?view=graph-rest-beta&preserve-view=true). -- [Stage the deletion](/graph/api/changetrackedentity-stagefordeletion?view=graph-rest-beta&preserve-view=true) of an [openShift](/graph/api/resources/openshift), [shift](/graph/api/resources/shift), or [timeOff](/graph/api/resources/timeoff) instance in a [schedule](/graph/api/resources/schedule) in draft mode. +- Get all [openShift](/graph/api/resources/openshift?view=graph-rest-beta&preserve-view=true) objects across all teams a user is a direct member of, removing the need to specify a team ID in the request. For more information, see [team: getOpenShifts](/graph/api/team-getopenshifts?view=graph-rest-beta&preserve-view=true). +- [Stage the deletion](/graph/api/changetrackedentity-stagefordeletion?view=graph-rest-beta&preserve-view=true) of an [openShift](/graph/api/resources/openshift?view=graph-rest-beta&preserve-view=true), [shift](/graph/api/resources/shift?view=graph-rest-beta&preserve-view=true), or [timeOff](/graph/api/resources/timeoff?view=graph-rest-beta&preserve-view=true) instance in a [schedule](/graph/api/resources/schedule?view=graph-rest-beta&preserve-view=true) in draft mode. For details, see the [related changelog section](https://developer.microsoft.com/en-us/graph/changelog/?search=958cb6cc-4eb0-4dec-a19d-7fe3da86b3ec)_. From d15e31dae3709c62dc128df79ccf0ae341aaea61 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Sat, 30 Nov 2024 21:43:52 +0100 Subject: [PATCH 108/144] Update whats-new-overview.md --- concepts/whats-new-overview.md | 134 ++------------------------------- 1 file changed, 7 insertions(+), 127 deletions(-) diff --git a/concepts/whats-new-overview.md b/concepts/whats-new-overview.md index 61bb788046d..b5e32d08996 100644 --- a/concepts/whats-new-overview.md +++ b/concepts/whats-new-overview.md @@ -17,6 +17,13 @@ For details about previous updates to Microsoft Graph, see [Microsoft Graph what > [!IMPORTANT] > Features in _preview_ status are subject to change without notice, and might not be promoted to generally available (GA) status. Don't use preview features in production apps. +## December 2024: New in preview only + +### Teamwork and communications | Shift management + +- [Stage the deletion](/graph/api/changetrackedentity-stagefordeletion) of an [openShift](/graph/api/resources/openshift), [shift](/graph/api/resources/shift), or [timeOff](/graph/api/resources/timeoff) instance in a [schedule](/graph/api/resources/schedule) in draft mode. +- Use the **eligibilityFilteringEnabledEntities** property on [workforceIntegration](/graph/api/resources/workforceintegration) to get or set support for viewing eligibility-filtered results. + ## November 2024: New and generally available ### Security | Identities @@ -75,133 +82,6 @@ Use the [getAllEnterpriseInteractions](/graph/api/aiInteractionHistory-getAllEnt - Use the **allowedLobbyAdmitters** property on [onlineMeeting](/graph/api/resources/onlinemeeting?view=graph-rest-beta&preserve-view=true) to get or set the users who can admit from the lobby. - [Get](/graph/api/copilotadminlimitedmode-get?view=graph-rest-beta&preserve-view=true) or [set](/graph/api/copilotadminlimitedmode-update?view=graph-rest-beta&preserve-view=true) whether users of Microsoft 365 Copilot in Teams Meetings can receive responses to sentiment-related prompts. -## October 2024: New and generally available - -### Backup storage - -Updated the endpoints of the following methods: -- [List driveProtectionUnits](/graph/api/backuprestoreroot-list-driveprotectionunits) -- [List mailboxProtectionUnits](/graph/api/backuprestoreroot-list-mailboxprotectionunits) -- [List siteProtectionUnits](/graph/api/backuprestoreroot-list-siteprotectionunits) - -### Change notifications - -Enabled the `$notifyOnUserSpecificProperties` query parameter as a value of the **resource** property in the [subscription](/graph/api/resources/subscription?view=graph-rest-beta&preserve-view=true) resource. You can use the [notifyOnUserSpecificProperties](/graph/teams-changenotifications-chat#notification-payloads-for-user-specific-properties) parameter when you subscribe to [notifications in a particular chat](/graph/teams-changenotifications-chat#subscribe-to-changes-in-a-particular-chat). - -### Identity and access | Directory management - -- [Get](/graph/api/domain-get-rootdomain) the root domain of a subdomain. -- Added recommendations to use unified RBAC APIs in [unifiedRoleDefinition](/graph/api/resources/unifiedroledefinition) instead of [directoryRole](/graph/api/resources/directoryrole) and [directoryRoleTemplate](/graph/api/resources/directoryroletemplate). -- Use the **membershipRule** property on [administrativeUnit](/graph/api/resources/administrativeunit) to get or set the dynamic membership rule for an administrative unit. -- Use the **membershipRuleProcessingState** property on [administrativeUnit](/graph/api/resources/administrativeunit) to indicate whether the dynamic membership rule is actively processed. -- Use the **membershipType** property on [administrativeUnit](/graph/api/resources/administrativeunit) to get or set the membership type for an administrative unit. - -### Security | eDiscovery - -- Enabled the deletion of Exchange mailbox items in the [ediscoverySearch: purgeData](/graph/api/security-ediscoverysearch-purgedata) method. -- Deleted the `permanentlyDeleted` member from the **purgeType** enumeration in favor of the `permanentlyDelete` member. -- Export [results](/graph/api/security-ediscoverysearch-exportresult) and a [report](/graph/api/security-ediscoverysearch-exportreport) from an [ediscoverySearch](/graph/api/resources/security-ediscoverysearch). -- Legal holds are holds that are tied to an eDiscovery case. To learn more about a legal hold policy and its supported methods, see [ediscoveryHoldPolicy](/graph/api/resources/security-ediscoveryholdpolicy). - -### Teamwork and communications | Apps - -Use the **clientAppId** property on [teamsAppAuthorization](/graph/api/resources/teamsappauthorization) to get the registration ID of the Microsoft Entra app ID associated with an [app](/graph/api/resources/teamsapp) in the Microsoft Teams app catalog. - -### Teamwork and communications | Calls and online meetings - -Use the **isDeltaRosterEnabled** property on [incomingCallOptions](/graph/api/resources/incomingcalloptions) and [outgoingCallOptions](/graph/api/resources/outgoingcalloptions) to indicate whether delta roster is enabled for a call. - -### Teamwork and communications | Messaging - -- Updated the [chatMessage: delta](/graph/api/chatmessage-delta) method to use a new endpoint that gets the list of delta messages from all chats in which a user is a participant, including one-on-one chats, group chats, and meeting chats. -- Use the **reactionContentUrl** property on [chatMessageReaction](/graph/api/resources/chatmessagereaction) to represent the hosted content URL for a custom reaction in a [chatMessage](/graph/api/resources/chatmessage). -- Use the `` tag on the **content** property of the [itemBody](/graph/api/resources/itembody) resource to represent custom emojis in the message body in a [chatMessage](/graph/api/resources/chatmessage). -- Use the **displayName** property on [chatMessageReaction](/graph/api/resources/chatmessagereaction) to represent the reaction name in a [chatMessage](/graph/api/resources/chatmessage). - -## October 2024: New in preview only - -### Backup storage - -Added new endpoints for bulk addition of protection units into a protection policy: -- [Create siteProtectionUnitsBulkAdditionJob](/graph/api/siteprotectionunitsbulkadditionjobs-post?view=graph-rest-beta&preserve-view=true) -- [List siteProtectionUnitsBulkAdditionJobs](/graph/api/sharepointprotectionpolicy-list-siteprotectionunitsbulkadditionjobs?view=graph-rest-beta&preserve-view=true) -- [Get siteProtectionUnitsBulkAdditionJob](/graph/api/siteprotectionunitsbulkadditionjobs-get?view=graph-rest-beta&preserve-view=true) - -- [Create mailboxProtectionUnitsBulkAdditionJob](/graph/api/mailboxprotectionunitsbulkadditionjobs-post?view=graph-rest-beta&preserve-view=true) -- [List mailboxProtectionUnitsBulkAdditionJobs](/graph/api/onedriveforbusinessprotectionpolicy-list-driveprotectionunitsbulkadditionjobs?view=graph-rest-beta&preserve-view=true) -- [Get mailboxProtectionUnitsBulkAdditionJob](/graph/api/mailboxprotectionunitsbulkadditionjobs-get?view=graph-rest-beta&preserve-view=true) - -- [Create driveProtectionUnitsBulkAdditionJob](/graph/api/driveprotectionunitsbulkadditionjobs-post?view=graph-rest-beta&preserve-view=true) -- [List driveProtectionUnitsBulkAdditionJobs](/graph/api/exchangeprotectionpolicy-list-mailboxprotectionunitsbulkadditionjobs?view=graph-rest-beta&preserve-view=true) -- [Get driveProtectionUnitsBulkAdditionJob](/graph/api/driveprotectionunitsbulkadditionjobs-get?view=graph-rest-beta&preserve-view=true) - -Updated the endpoints of the following methods: -- [List driveProtectionUnits](/graph/api/backuprestoreroot-list-driveprotectionunits?view=graph-rest-beta&preserve-view=true) -- [List mailboxProtectionUnits](/graph/api/backuprestoreroot-list-mailboxprotectionunits?view=graph-rest-beta&preserve-view=true) -- [List siteProtectionUnits](/graph/api/backuprestoreroot-list-siteprotectionunits?view=graph-rest-beta&preserve-view=true) - -### Device and app management | Cloud licensing - -- Use the new cloud licensing [usageRight](/graph/api/resources/cloudlicensing-usageright?view=graph-rest-beta&preserve-view=true) entity that is designed for client and workload license checks, with relationships structured to flow from the user or group to the **usageRight**. This new entity supports the following operations: - - [List usage rights for a group](/graph/api/cloudlicensing-groupcloudlicensing-list-usagerights?view=graph-rest-beta&preserve-view=true) - - [List usage rights for a user](/graph/api/cloudlicensing-usercloudlicensing-list-usagerights?view=graph-rest-beta&preserve-view=true) - - [Get usage rights for a group or user](/graph/api/cloudlicensing-usageright-get?view=graph-rest-beta&preserve-view=true) -- Use the **cloudLicensing** property on a [group](/graph/api/resources/group?view=graph-rest-beta&preserve-view=true) or [user](/graph/api/resources/user?view=graph-rest-beta&preserve-view=true) to get their relationships with cloud licensing resources. - -### Device and app management | Cloud PC - -- Enabled the `$select` query parameter for the [cloudPC: getProvisionedCloudPCs](/graph/api/cloudpc-getprovisionedcloudpcs?view=graph-rest-beta&preserve-view=true) method. -- Use the **notificationSetting** property on [cloudPcUserSetting](/graph/api/resources/cloudpcnotificationsetting?view=graph-rest-beta&preserve-view=true) to define the Cloud PC notification prompts for a Cloud PC user. -- Enabled the `cloudPcFrontlineBufferUsageScenario` member in the **alertRuleTemplate** enumeration. -- Enabled the `frontlineBufferUsageDuration` and `frontlineBufferUsageThreshold` members in the **ruleCondition** enumeration. - -### Identity and access | Directory management - -Get or update the [uxSetting](/graph/api/resources/uxsetting?view=graph-rest-beta&preserve-view=true) that restricts access to Microsoft Entra admin center to only administrators. - -### Identity and access | Identity and sign-in - -Enabled `suspiciousAPITraffic` as a supported value for the **riskEventType** property in the [servicePrincipalRiskDetection](/graph/api/resources/serviceprincipalriskdetection?view=graph-rest-beta&preserve-view=true) resource. You can retrieve this value when you use either the [List servicePrincipalRiskDetections](/graph/api/identityprotectionroot-list-serviceprincipalriskdetections?view=graph-rest-beta&preserve-view=true) or [Get servicePrincipalRiskDetection](/graph/api/serviceprincipalriskdetection-get?view=graph-rest-beta&preserve-view=true) APIs. - -### Reports | Identity and access reports - -The Microsoft Entra Health monitoring alerts APIs enable you to detect anomalous usage patterns in business-critical identity scenarios for your tenant and receive alert notifications. Use the operations of the [alert](/graph/api/resources/healthmonitoring-alert?view=graph-rest-beta&preserve-view=true) and [alertConfiguration](/graph/api/resources/healthmonitoring-alertconfiguration?view=graph-rest-beta&preserve-view=true) resources to retrieve and update alerts and alert configurations. For details, see the [related changelog section](https://developer.microsoft.com/graph/changelog/?search=277da918-3e81-499f-8803-2986a2c73123). - -### Security | eDiscovery - -- Enabled the deletion of Exchange mailbox items in the [ediscoverySearch: purgeData](/graph/api/security-ediscoverysearch-purgedata?view=graph-rest-beta&preserve-view=true) method. -- Deleted the `permanentlyDeleted` member from the **purgeType** enumeration in favor of the `permanentlyDelete` member. - -### Sites and lists - -Updated the endpoints of the following methods: -- [Get](/graph/api/pagetemplate-get?view=graph-rest-beta&preserve-view=true) -- [Update](/graph/api/pagetemplate-update?view=graph-rest-beta&preserve-view=true) -- [Delete](/graph/api/pagetemplate-delete?view=graph-rest-beta&preserve-view=true) - -### Teamwork and communications | Calls and online meetings - -- Use the **externalRegistrationInformation** property on [virtualEventRegistration](/graph/api/resources/virtualeventregistration?view=graph-rest-betaa&preserve-view=true) to get or set the external information for a virtual event registration. -- Use the following new methods for virtual events that are of the [virtualEventTownhall](/graph/api/resources/virtualeventtownhall?view=graph-rest-beta&preserve-view=true) type: - - [List](/graph/api/virtualeventsroot-list-townhalls?view=graph-rest-beta&preserve-view=true) all virtual event town halls created in a tenant. - - [Get](/graph/api/virtualeventtownhall-getbyuseridandrole?view=graph-rest-beta&preserve-view=true) the virtual event town halls where a specified user is an organizer or coorganizer. - - [Get](/graph/api/virtualeventtownhall-getbyuserrole?view=graph-rest-beta&preserve-view=true) the virtual event town halls where the signed-in user is an organizer or coorganizer. - -### Teamwork and communications | Messaging - -- Updated the [chatMessage: delta](/graph/api/chatmessage-delta?view=graph-rest-beta&preserve-view=true) method to use a new endpoint that gets the list of delta messages from all chats in which a user is a participant, including one-on-one chats, group chats, and meeting chats. -- [Get](/graph/api/chatmessage-get?view=graph-rest-beta&preserve-view=true#example-6-get-a-chat-message-with-a-forwarded-message) a chat message that has a forwarded message as an attachment. -- [Remove multiple members](/graph/api/conversationmember-remove?view=graph-rest-beta&preserve-view=true) from a [team](/graph/api/resources/team?view=graph-rest-beta&preserve-view=true) in a single request. - -### Users - -Changed the following on-premises synced properties of the [user](/graph/api/resources/user?view=graph-rest-beta&preserve-view=true) resource type that were read-only in Microsoft Graph to be updatable via Microsoft Graph: -- onPremisesDistinguishedName -- onPremisesDomainName -- onPremisesSamAccountName -- onPremisesSecurityIdentifier -- onPremisesUserPrincipalName - ## Contribute to Microsoft Graph Are there scenarios you'd like Microsoft Graph to support? From c1cc4be00ec3119d494d44a7fa41e2f886a4e09a Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Mon, 2 Dec 2024 12:22:34 +0530 Subject: [PATCH 109/144] Update api-reference/beta/resources/mailboxrestoreartifact.md Co-authored-by: mnorman-ms --- api-reference/beta/resources/mailboxrestoreartifact.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/mailboxrestoreartifact.md b/api-reference/beta/resources/mailboxrestoreartifact.md index e8d8dd26e37..efa85b779bf 100644 --- a/api-reference/beta/resources/mailboxrestoreartifact.md +++ b/api-reference/beta/resources/mailboxrestoreartifact.md @@ -32,7 +32,7 @@ Inherits from [restoreArtifactBase](../resources/restoreartifactbase.md). |error|[publicError](../resources/publicerror.md)|Contains error details if the restoration of the artifact fails. Inherited from [restoreArtifactBase](../resources/restoreartifactbase.md).| |restoredFolderId|String|The new restored folder identifier for the user.| |restoredFolderName|String|The new restored folder name.| -|restoredItemCount|Int32|Number of items that are being restored in the folder.| +|restoredItemCount|Int32|The number of items that are being restored in the folder.| |startDateTime|DateTimeOffset|The time when the restoration of the artifact started. Inherited from [restoreArtifactBase](../resources/restoreartifactbase.md).| |status|[artifactRestoreStatus](../resources/mailboxrestoreartifact.md#artifactrestorestatus-values)|The restoration status of the artifact. Inherited from [restoreArtifactBase](../resources/restoreartifactbase.md). The possible values are: `added`, `scheduling`, `scheduled`, `inProgress`, `succeeded`, `failed`, `unknownFutureValue`.| From 0fc8cca51c293d53262feeacc70ae423f80ec99e Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Mon, 2 Dec 2024 12:22:49 +0530 Subject: [PATCH 110/144] Update api-reference/beta/resources/granularmailboxrestoreartifact.md Co-authored-by: mnorman-ms --- api-reference/beta/resources/granularmailboxrestoreartifact.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/granularmailboxrestoreartifact.md b/api-reference/beta/resources/granularmailboxrestoreartifact.md index 9e7f0b3bffc..ee6c205dc11 100644 --- a/api-reference/beta/resources/granularmailboxrestoreartifact.md +++ b/api-reference/beta/resources/granularmailboxrestoreartifact.md @@ -33,7 +33,7 @@ Inherits from [mailboxRestoreArtifact](../resources/mailboxRestoreArtifact.md). |error|[publicError](../resources/publicerror.md)|Contains error details if the restoration of the artifact fails. Inherited from [restoreArtifactBase](../resources/restoreartifactbase.md).| |restoredFolderId|String|The new restored folder identifier for the user.| |restoredFolderName|String|The new restored folder name.| -|restoredItemCount|Int32|Number of items that are being restored in the folder.| +|restoredItemCount|Int32|The number of items that are being restored in the folder.| |searchResponseId|String|.| |startDateTime|DateTimeOffset|The time when the restoration of the artifact started. Inherited from [restoreArtifactBase](../resources/restoreartifactbase.md).| |status|[artifactRestoreStatus](../resources/mailboxrestoreartifact.md#artifactrestorestatus-values)|The restoration status of the artifact. Inherited from [restoreArtifactBase](../resources/restoreartifactbase.md). The possible values are: `added`, `scheduling`, `scheduled`, `inProgress`, `succeeded`, `failed`, `unknownFutureValue`.| From 47a5c7cda09e674c3e3d28e7f28ca79b65deda97 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Mon, 2 Dec 2024 12:27:23 +0530 Subject: [PATCH 111/144] Update backuprestoreroot-post-onedriveforbusinessrestoresessions.md --- ...backuprestoreroot-post-onedriveforbusinessrestoresessions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md b/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md index e6673ec7503..73f3a832882 100644 --- a/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md +++ b/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md @@ -1,6 +1,6 @@ --- title: "Create oneDriveForBusinessRestoreSession" -description: "Create a new OneDrive restore session." +description: "Create a new OneDrive for Business restore session." author: "tushar20" ms.reviewer: "manikantsinghms" ms.localizationpriority: medium From 1ade5a452797393bb990e6563d978551e30fc24e Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Mon, 2 Dec 2024 12:42:02 +0530 Subject: [PATCH 112/144] Update backuprestoreroot-enable.md --- api-reference/beta/api/backuprestoreroot-enable.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/api-reference/beta/api/backuprestoreroot-enable.md b/api-reference/beta/api/backuprestoreroot-enable.md index de1c7b576f8..3a3327b6552 100644 --- a/api-reference/beta/api/backuprestoreroot-enable.md +++ b/api-reference/beta/api/backuprestoreroot-enable.md @@ -12,8 +12,6 @@ doc_type: apiPageType Namespace: microsoft.graph -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - Enable the [Microsoft 365 Backup Storage](../resources/backuprestoreroot.md) service for a tenant. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] @@ -47,7 +45,7 @@ In the request body, supply a JSON representation of the following parameter. |Parameter|Type|Description| |:---|:---|:---| -|appOwnerTenantId|String|The ID of the tenant in which this application is registered. Required.| +|appOwnerTenantId|String|The ID of the owning tenant in which the billing profile is created.| ## Response @@ -58,6 +56,7 @@ If successful, this action returns a `200 OK` response code and a [serviceStatus ### Request The following example shows a request. + # [HTTP](#tab/http) ``` http -POST https://graph.microsoft.com/beta/solutions/backupRestore/enable +POST https://graph.microsoft.com/v1.0/solutions/backupRestore/enable { "appOwnerTenantId": "23014d8c-71fe-4d00-a01a-31850bc5b42a" @@ -135,4 +134,3 @@ HTTP/1.1 200 OK "lastModifiedDateTime":"2023-06-19T12:01:03.45Z" } ``` - From c45e8367e35a05b44fdc8cf83d7211cd90000142 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Mon, 2 Dec 2024 12:45:17 +0530 Subject: [PATCH 113/144] Update backuprestoreroot-enable.md --- api-reference/beta/api/backuprestoreroot-enable.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/backuprestoreroot-enable.md b/api-reference/beta/api/backuprestoreroot-enable.md index 3a3327b6552..d73232f0dd6 100644 --- a/api-reference/beta/api/backuprestoreroot-enable.md +++ b/api-reference/beta/api/backuprestoreroot-enable.md @@ -12,6 +12,8 @@ doc_type: apiPageType Namespace: microsoft.graph +[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] + Enable the [Microsoft 365 Backup Storage](../resources/backuprestoreroot.md) service for a tenant. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] @@ -56,7 +58,6 @@ If successful, this action returns a `200 OK` response code and a [serviceStatus ### Request The following example shows a request. - # [HTTP](#tab/http) ``` http -POST https://graph.microsoft.com/v1.0/solutions/backupRestore/enable +POST https://graph.microsoft.com/beta/solutions/backupRestore/enable { "appOwnerTenantId": "23014d8c-71fe-4d00-a01a-31850bc5b42a" From 843f52d9fc91c7c0f96f0ae4be01a3e50b1a5030 Mon Sep 17 00:00:00 2001 From: mnorman-ms Date: Mon, 2 Dec 2024 14:28:00 +0700 Subject: [PATCH 114/144] Business => Work or School --- ...backuprestoreroot-post-onedriveforbusinessrestoresessions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md b/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md index 73f3a832882..b52b7f44fb0 100644 --- a/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md +++ b/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md @@ -1,6 +1,6 @@ --- title: "Create oneDriveForBusinessRestoreSession" -description: "Create a new OneDrive for Business restore session." +description: "Create a new OneDrive for Work or School restore session." author: "tushar20" ms.reviewer: "manikantsinghms" ms.localizationpriority: medium From 073ddeed890e03213c233a73498aeeb5bf2a0eaf Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Mon, 2 Dec 2024 11:19:45 -0800 Subject: [PATCH 115/144] fix comment --- api-reference/v1.0/api/openshift-post.md | 4 +- .../v1.0/api/schedule-list-timeoffreasons.md | 63 ++++++++++--------- .../v1.0/api/schedule-post-shifts.md | 4 ++ .../v1.0/api/schedule-post-timesoff.md | 5 +- api-reference/v1.0/api/timeoff-put.md | 3 +- .../v1.0/api/workforceintegration-post.md | 8 ++- .../v1.0/api/workforceintegration-update.md | 2 +- .../v1.0/resources/workforceintegration.md | 2 +- 8 files changed, 52 insertions(+), 39 deletions(-) diff --git a/api-reference/v1.0/api/openshift-post.md b/api-reference/v1.0/api/openshift-post.md index aac1821d531..6416833e6d0 100644 --- a/api-reference/v1.0/api/openshift-post.md +++ b/api-reference/v1.0/api/openshift-post.md @@ -43,7 +43,9 @@ POST /teams/{id}/schedule/openShifts ## Request body -Provide the modified [openShift](../resources/openshift.md) object in the request body for this method. +In the request body, supply a JSON representation of the modified [openShift](../resources/openshift.md) object. + +The following table lists the properties that you can use when you create an **openShift** object. |Property|Type|Description| |:---|:---|:---| diff --git a/api-reference/v1.0/api/schedule-list-timeoffreasons.md b/api-reference/v1.0/api/schedule-list-timeoffreasons.md index 7726ee56a11..714b907c3e3 100644 --- a/api-reference/v1.0/api/schedule-list-timeoffreasons.md +++ b/api-reference/v1.0/api/schedule-list-timeoffreasons.md @@ -116,40 +116,41 @@ Content-type: application/json { "value": [ { - "@odata.type": "#microsoft.graph.timeOff", - "id": "d8aa6cc9-7a1a-fb34-ed9c-e1ac3dcd54c8", - "createdDateTime": "String (timestamp)", - "lastModifiedDateTime": "String (timestamp)", - "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" - }, - "sharedTimeOff": { - "@odata.type": "microsoft.graph.timeOffItem" - }, - "draftTimeOff": { - "@odata.type": "microsoft.graph.timeOffItem" - }, - "userId": "String", - "isStagedForDeletion": "Boolean" + "id": "TOR_7e5935da-7031-4dc1-850b-7304dbb822af", + "createdDateTime": null, + "lastModifiedDateTime": "2024-11-29T07:46:02.635Z", + "displayName": "Parental Leave", + "iconType": "cake", + "isActive": false, + "lastModifiedBy": { + "application": null, + "device": null, + "user": { + "id": "24af8b1e-f894-491c-bde2-0c705ef3fbcd", + "displayName": "John Doe", + "userIdentityType": "aadUser", + "tenantId": null + } + } }, { - "@odata.type": "#microsoft.graph.timeOff", - "id": "d8aa6cc9-7a1a-fb34-ed9c-e1ac3dcd54c8", - "createdDateTime": "String (timestamp)", - "lastModifiedDateTime": "String (timestamp)", - "lastModifiedBy": { - "@odata.type": "microsoft.graph.identitySet" - }, - "sharedTimeOff": { - "@odata.type": "microsoft.graph.timeOffItem" - }, - "draftTimeOff": { - "@odata.type": "microsoft.graph.timeOffItem" - }, - "userId": "String", - "isStagedForDeletion": "Boolean" + "id": "TOR_078523b9-8c8e-4a2b-8c20-3a3b52410975", + "createdDateTime": null, + "lastModifiedDateTime": "2024-11-29T07:34:58.879Z", + "displayName": "Sick Day", + "iconType": "doctor", + "isActive": false, + "lastModifiedBy": { + "application": null, + "device": null, + "user": { + "id": "24af8b1e-f894-491c-bde2-0c705ef3fbcd", + "displayName": "John Doe", + "userIdentityType": "aadUser", + "tenantId": null + } + } } - ] } ``` diff --git a/api-reference/v1.0/api/schedule-post-shifts.md b/api-reference/v1.0/api/schedule-post-shifts.md index e57ec1b7679..66f885bb887 100644 --- a/api-reference/v1.0/api/schedule-post-shifts.md +++ b/api-reference/v1.0/api/schedule-post-shifts.md @@ -43,6 +43,10 @@ POST /teams/{teamId}/schedule/shifts ## Request body +In the request body, supply a JSON representation of the modified [shift](../resources/shift.md) object. + +The following table lists the properties that you can use when you create an **Shift** object. + |Property|Type|Description| |:---|:---|:---| | draftShift | [shiftItem](../resources/shiftitem.md) | Draft changes in the **shift**. Draft changes are only visible to managers. The changes are visible to employees when they're [shared](../api/schedule-share.md), which copies the changes from the **draftShift** to the **sharedShift** property. Eiher draShift or sharedShift should be null.| diff --git a/api-reference/v1.0/api/schedule-post-timesoff.md b/api-reference/v1.0/api/schedule-post-timesoff.md index da626eef0b6..aea9e357cbf 100644 --- a/api-reference/v1.0/api/schedule-post-timesoff.md +++ b/api-reference/v1.0/api/schedule-post-timesoff.md @@ -43,7 +43,10 @@ POST /teams/{teamId}/schedule/timesOff ## Request body -In the request body, supply a modified JSON representation of a [timeOff](../resources/timeoff.md) object. +In the request body, supply a JSON representation of the modified [timeOff](../resources/timeoff.md) object. + +The following table lists the properties that you can use when you create an **TimeOff** object. + |Property|Type|Description| |:---|:---|:---| diff --git a/api-reference/v1.0/api/timeoff-put.md b/api-reference/v1.0/api/timeoff-put.md index c5db7bdff3c..b517773a592 100644 --- a/api-reference/v1.0/api/timeoff-put.md +++ b/api-reference/v1.0/api/timeoff-put.md @@ -55,7 +55,7 @@ In the request body, supply a modified JSON representation of a [timeOff](../res ## Response -If successful, this method returns a `200 OK` response code and a [timeOff](../resources/timeoff.md) object in the response body. +If successful, this method returns a `204 No Content` response code and empty content. If the request specifies the `Prefer` header with `return=representation` preference, then this method returns a `200 OK` response code and a [timeOff](../resources/timeoff.md) object in the response body. ## Example @@ -72,7 +72,6 @@ The following example shows a request. ```http PUT https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/timesOff/{timeOffId} Content-type: application/json -Prefer: return=representation { "userId": "aa162a04-bec6-4b81-ba99-96caa7b2b24d", diff --git a/api-reference/v1.0/api/workforceintegration-post.md b/api-reference/v1.0/api/workforceintegration-post.md index e8af5b0621d..963d77d3975 100644 --- a/api-reference/v1.0/api/workforceintegration-post.md +++ b/api-reference/v1.0/api/workforceintegration-post.md @@ -44,7 +44,11 @@ POST /teamwork/workforceIntegrations ## Request body -In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed. +In the request body, supply a JSON representation of the [workforceIntegration](../resources/workforceintegration.md) object. + +Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed. + +The following table lists the properties that you can use when you create an **WorkforceIntegration** object. | Property | Type | Description | |:-------------|:------------|:------------| @@ -53,7 +57,7 @@ In the request body, supply the values for relevant fields that should be update |eligibilityFilteringEnabledEntities|eligibilityFilteringEnabledEntities| Support to view eligibility-filtered results. Possible values are: `none`, `swapRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason`.| |encryption|[workforceIntegrationEncryption](../resources/workforceintegrationencryption.md)|The workforce integration encryption resource.| |isActive|Boolean|Indicates whether this workforce integration is currently active and available.| -|supportedEntities|workforceIntegrationSupportedEntities | The Shifts entities supported for synchronous change notifications. Shifts will make a call back to the url provided on client changes on those entities added here. By default, no entities are supported for change notifications. Possible values are: `none`, `shift`, `swapRequest`, `userShiftPreferences`, `openShift`, `openShiftRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`, `timeOff`, `timeOffRequest`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason` , `timeOff` , `timeOffRequest`.| +|supportedEntities|workforceIntegrationSupportedEntities | The Shifts entities supported for synchronous change notifications. Shifts call back to the provided URL when client changes occur to the entities specified in this property. By default, no entities are supported for change notifications. Possible values are: `none`, `shift`, `swapRequest`, `userShiftPreferences`, `openShift`, `openShiftRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`, `timeOff`, `timeOffRequest`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason` , `timeOff` , `timeOffRequest`.| |url|String| Workforce Integration URL for callbacks from the Shifts service.| ## Response diff --git a/api-reference/v1.0/api/workforceintegration-update.md b/api-reference/v1.0/api/workforceintegration-update.md index 7d219943957..22b411de173 100644 --- a/api-reference/v1.0/api/workforceintegration-update.md +++ b/api-reference/v1.0/api/workforceintegration-update.md @@ -51,7 +51,7 @@ In the request body, supply the values for relevant fields that should be update |eligibilityFilteringEnabledEntities|eligibilityFilteringEnabledEntities| Support to view eligibility-filtered results. Possible values are: `none`, `swapRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason`.| |encryption|[workforceIntegrationEncryption](../resources/workforceintegrationencryption.md)|The workforce integration encryption resource.| |isActive|Boolean|Indicates whether this workforce integration is currently active and available.| -|supportedEntities|workforceIntegrationSupportedEntities | The Shifts entities supported for synchronous change notifications. Shifts will make a call back to the url provided on client changes on those entities added here. By default, no entities are supported for change notifications. Possible values are: `none`, `shift`, `swapRequest`, `userShiftPreferences`, `openShift`, `openShiftRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`, `timeOff`, `timeOffRequest`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason` , `timeOff` , `timeOffRequest`.| +|supportedEntities|workforceIntegrationSupportedEntities | The Shifts entities supported for synchronous change notifications. Shifts call back to the provided URL when client changes occur to the entities specified in this property. By default, no entities are supported for change notifications. Possible values are: `none`, `shift`, `swapRequest`, `userShiftPreferences`, `openShift`, `openShiftRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`, `timeOff`, `timeOffRequest`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason` , `timeOff` , `timeOffRequest`.| |url|String| Workforce Integration URL for callbacks from the Shifts service.| ## Response diff --git a/api-reference/v1.0/resources/workforceintegration.md b/api-reference/v1.0/resources/workforceintegration.md index b3b0115953d..62225775dda 100644 --- a/api-reference/v1.0/resources/workforceintegration.md +++ b/api-reference/v1.0/resources/workforceintegration.md @@ -29,7 +29,7 @@ Represents an instance of a workforce integration with shifts. | Property | Type | Description | |:-------------|:------------|:------------| |apiVersion|Int32|API version for the call back URL. Start with 1.| -|createdDateTime|DateTimeOffset|Inherited from [changeTrackedEntity](../resources/changetrackedentity.md).| +|createdDateTime|DateTimeOffset|The timestamp on which this **WorkforceIntegration** was first created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [changeTrackedEntity](../resources/changetrackedentity.md).| |displayName|String|Name of the workforce integration.| |eligibilityFilteringEnabledEntities|eligibilityFilteringEnabledEntities| Support to view eligibility-filtered results. Possible values are: `none`, `swapRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason`.| |encryption|[workforceIntegrationEncryption](workforceintegrationencryption.md)|The workforce integration encryption resource.| From a7495d871398c331da35ad4ccf73eec972931b06 Mon Sep 17 00:00:00 2001 From: satpatel1 <161823598+satpatel1@users.noreply.github.com> Date: Tue, 3 Dec 2024 12:58:15 +0530 Subject: [PATCH 116/144] Update api-reference/beta/resources/restoresessionartifactcount.md Co-authored-by: mnorman-ms --- .../beta/resources/restoresessionartifactcount.md | 11 ----------- 1 file changed, 11 deletions(-) diff --git a/api-reference/beta/resources/restoresessionartifactcount.md b/api-reference/beta/resources/restoresessionartifactcount.md index 1dcbe51fcd7..c4702bad807 100644 --- a/api-reference/beta/resources/restoresessionartifactcount.md +++ b/api-reference/beta/resources/restoresessionartifactcount.md @@ -17,17 +17,6 @@ Namespace: microsoft.graph Represents artifact count metadata for a [restore session](../resources/restoreSessionBase.md). Restore session APIs are used by SharePoint, OneDrive, and Exchange Online admins to perform restore-related tasks on artifacts that are protected as part of a protection policy. -## Methods - -|Method|Return type|Description| -|:---|:---|:---| -|[List](../api/backuprestoreroot-list-restoresessions.md)|[restoreSessionBase](../resources/restoresessionbase.md) collection|Get a list of [restoreSessionBase](../resources/restoresessionbase.md) objects and their properties.| -|[Get](../api/restoresessionbase-get.md)|[restoreSessionBase](../resources/restoresessionbase.md)|Read the properties and relationships of a [restoreSessionBase](../resources/restoresessionbase.md) object.| -|[Activate](../api/restoresessionbase-activate.md)|[restoreSessionBase](../resources/restoresessionbase.md)|Activate a draft restore session.| -|[Create a SharePoint restore session](../api/backuprestoreroot-post-sharepointrestoresessions.md)|[sharePointRestoreSession](../resources/sharepointrestoresession.md)|Create a new [sharePointRestoreSession](../resources/sharepointrestoresession.md).| -|[Create a OneDrive restore session](../api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md)|[oneDriveForBusinessRestoreSession](../resources/onedriveforbusinessrestoresession.md)|Create a new [oneDriveForBusinessRestoreSession](../resources/onedriveforbusinessrestoresession.md).| -|[Create an Exchange restore session](../api/backuprestoreroot-post-exchangerestoresessions.md)|[exchangeRestoreSession](../resources/exchangerestoresession.md)|Create a new [exchangeRestoreSession](../resources/exchangerestoresession.md).| - ## Properties |Property|Type|Description| From 051ebbca299d40edd1dc32910a191d62e90065d4 Mon Sep 17 00:00:00 2001 From: mnorman-ms Date: Tue, 3 Dec 2024 14:48:35 +0700 Subject: [PATCH 117/144] Reworded appOwnerTenantId property description in v1.0 and beta backuprestoreroot-enable.md --- api-reference/beta/api/backuprestoreroot-enable.md | 2 +- api-reference/v1.0/api/backuprestoreroot-enable.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/backuprestoreroot-enable.md b/api-reference/beta/api/backuprestoreroot-enable.md index d73232f0dd6..c61b9a67037 100644 --- a/api-reference/beta/api/backuprestoreroot-enable.md +++ b/api-reference/beta/api/backuprestoreroot-enable.md @@ -47,7 +47,7 @@ In the request body, supply a JSON representation of the following parameter. |Parameter|Type|Description| |:---|:---|:---| -|appOwnerTenantId|String|The ID of the owning tenant in which the billing profile is created.| +|appOwnerTenantId|String|The ID of the owning tenant. The owning tenant contains the billing profile.| ## Response diff --git a/api-reference/v1.0/api/backuprestoreroot-enable.md b/api-reference/v1.0/api/backuprestoreroot-enable.md index 5c181b7dac1..011d1a80fd2 100644 --- a/api-reference/v1.0/api/backuprestoreroot-enable.md +++ b/api-reference/v1.0/api/backuprestoreroot-enable.md @@ -46,7 +46,7 @@ In the request body, supply a JSON representation of the following parameter. |Parameter|Type|Description| |:---|:---|:---| -|appOwnerTenantId|String|The ID of the owning tenant in which the billing profile is created.| +|appOwnerTenantId|String|The ID of the owning tenant. The owning tenant contains the billing profile.| ## Response From 01686ac4b27fa735e9c03b0be69f46e519821054 Mon Sep 17 00:00:00 2001 From: Victor Cheng <59785657+victorcheng0425@users.noreply.github.com> Date: Tue, 3 Dec 2024 16:39:16 -0800 Subject: [PATCH 118/144] fix --- api-reference/v1.0/api/schedule-list-timeoffreasons.md | 1 + 1 file changed, 1 insertion(+) diff --git a/api-reference/v1.0/api/schedule-list-timeoffreasons.md b/api-reference/v1.0/api/schedule-list-timeoffreasons.md index 714b907c3e3..28bbb00bde3 100644 --- a/api-reference/v1.0/api/schedule-list-timeoffreasons.md +++ b/api-reference/v1.0/api/schedule-list-timeoffreasons.md @@ -151,6 +151,7 @@ Content-type: application/json } } } + ] } ``` From 3a78c97b063a10cfebc1559031e007a714e18f3b Mon Sep 17 00:00:00 2001 From: Microsoft Graph DevX Tooling Date: Wed, 4 Dec 2024 10:01:52 +0000 Subject: [PATCH 119/144] Update generated permissions tables with build 172990 [skip ci] --- .../aiinteractionhistory-getallenterpriseinteractions.md | 2 +- api-reference/beta/api/newslinkpage-list.md | 6 +----- api-reference/beta/api/sitepage-createfromtemplate.md | 2 +- .../application-post-onlinemeetings-2-permissions.md | 3 ++- .../application-post-onlinemeetings-permissions.md | 3 ++- .../fido2authenticationmethod-delete-2-permissions.md | 2 +- .../fido2authenticationmethod-delete-permissions.md | 2 +- .../includes/permissions/newslinkpage-create-permissions.md | 3 ++- .../includes/permissions/newslinkpage-list-permissions.md | 3 ++- .../permissions/onlinemeeting-delete-2-permissions.md | 3 ++- .../permissions/onlinemeeting-delete-permissions.md | 3 ++- .../includes/permissions/onlinemeeting-get-2-permissions.md | 3 ++- .../includes/permissions/onlinemeeting-get-3-permissions.md | 3 ++- .../includes/permissions/onlinemeeting-get-4-permissions.md | 3 ++- .../includes/permissions/onlinemeeting-get-5-permissions.md | 3 ++- .../includes/permissions/onlinemeeting-get-permissions.md | 3 ++- .../permissions/onlinemeeting-update-2-permissions.md | 3 ++- .../permissions/onlinemeeting-update-permissions.md | 3 ++- .../permissions/sitepage-createfromtemplate-permissions.md | 4 ++-- .../application-post-onlinemeetings-2-permissions.md | 3 ++- .../application-post-onlinemeetings-permissions.md | 3 ++- .../emailauthenticationmethod-get-permissions.md | 3 ++- .../permissions/onlinemeeting-delete-2-permissions.md | 3 ++- .../permissions/onlinemeeting-delete-permissions.md | 3 ++- .../includes/permissions/onlinemeeting-get-2-permissions.md | 3 ++- .../includes/permissions/onlinemeeting-get-3-permissions.md | 3 ++- .../includes/permissions/onlinemeeting-get-4-permissions.md | 3 ++- .../includes/permissions/onlinemeeting-get-5-permissions.md | 3 ++- .../includes/permissions/onlinemeeting-get-permissions.md | 3 ++- .../permissions/onlinemeeting-update-2-permissions.md | 3 ++- .../permissions/onlinemeeting-update-permissions.md | 3 ++- 31 files changed, 57 insertions(+), 36 deletions(-) diff --git a/api-reference/beta/api/aiinteractionhistory-getallenterpriseinteractions.md b/api-reference/beta/api/aiinteractionhistory-getallenterpriseinteractions.md index 7b6153ffd42..30e78b00c5a 100644 --- a/api-reference/beta/api/aiinteractionhistory-getallenterpriseinteractions.md +++ b/api-reference/beta/api/aiinteractionhistory-getallenterpriseinteractions.md @@ -22,7 +22,7 @@ Namespace: microsoft.graph 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](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). - + [!INCLUDE [permissions-table](../includes/permissions/aiinteractionhistory-getallenterpriseinteractions-permissions.md)] ## HTTP request diff --git a/api-reference/beta/api/newslinkpage-list.md b/api-reference/beta/api/newslinkpage-list.md index cd9438f34c7..64848773a7f 100644 --- a/api-reference/beta/api/newslinkpage-list.md +++ b/api-reference/beta/api/newslinkpage-list.md @@ -20,11 +20,7 @@ Get a list of the [newsLinkPage](../resources/newslinkpage.md) objects and their 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](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). - + [!INCLUDE [permissions-table](../includes/permissions/newslinkpage-list-permissions.md)] ## HTTP request diff --git a/api-reference/beta/api/sitepage-createfromtemplate.md b/api-reference/beta/api/sitepage-createfromtemplate.md index 89a53729091..77b39b4e14d 100644 --- a/api-reference/beta/api/sitepage-createfromtemplate.md +++ b/api-reference/beta/api/sitepage-createfromtemplate.md @@ -20,7 +20,7 @@ Create a new [sitePage](../resources/sitepage.md) from a [pageTemplate](../resou 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](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). - + [!INCLUDE [permissions-table](../includes/permissions/sitepage-createfromtemplate-permissions.md)] ## HTTP request diff --git a/api-reference/beta/includes/permissions/application-post-onlinemeetings-2-permissions.md b/api-reference/beta/includes/permissions/application-post-onlinemeetings-2-permissions.md index d844cc38cc5..1aadd70309d 100644 --- a/api-reference/beta/includes/permissions/application-post-onlinemeetings-2-permissions.md +++ b/api-reference/beta/includes/permissions/application-post-onlinemeetings-2-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetings.ReadWrite|Not available.| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|OnlineMeetings.ReadWrite.All|Not available.| \ No newline at end of file +|Application|OnlineMeetings.ReadWrite.All|Not available.| + diff --git a/api-reference/beta/includes/permissions/application-post-onlinemeetings-permissions.md b/api-reference/beta/includes/permissions/application-post-onlinemeetings-permissions.md index 23fb3ba2aea..74b203496ea 100644 --- a/api-reference/beta/includes/permissions/application-post-onlinemeetings-permissions.md +++ b/api-reference/beta/includes/permissions/application-post-onlinemeetings-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetings.ReadWrite|Not available.| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Not supported.|Not supported.| \ No newline at end of file +|Application|Not supported.|Not supported.| + diff --git a/api-reference/beta/includes/permissions/fido2authenticationmethod-delete-2-permissions.md b/api-reference/beta/includes/permissions/fido2authenticationmethod-delete-2-permissions.md index 9184b7059c0..6e505efdebb 100644 --- a/api-reference/beta/includes/permissions/fido2authenticationmethod-delete-2-permissions.md +++ b/api-reference/beta/includes/permissions/fido2authenticationmethod-delete-2-permissions.md @@ -6,7 +6,7 @@ ms.localizationpriority: medium |Permission type|Least privileged permissions|Higher privileged permissions| |:---|:---|:---| -|Delegated (work or school account)|UserAuthenticationMethod.ReadWrite.All|Not available.| +|Delegated (work or school account)|UserAuthenticationMethod.ReadWrite|UserAuthenticationMethod.ReadWrite.All| |Delegated (personal Microsoft account)|Not supported.|Not supported.| |Application|UserAuthenticationMethod.ReadWrite.All|Not available.| diff --git a/api-reference/beta/includes/permissions/fido2authenticationmethod-delete-permissions.md b/api-reference/beta/includes/permissions/fido2authenticationmethod-delete-permissions.md index b87b92215f3..6e505efdebb 100644 --- a/api-reference/beta/includes/permissions/fido2authenticationmethod-delete-permissions.md +++ b/api-reference/beta/includes/permissions/fido2authenticationmethod-delete-permissions.md @@ -8,5 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|UserAuthenticationMethod.ReadWrite|UserAuthenticationMethod.ReadWrite.All| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Not supported.|Not supported.| +|Application|UserAuthenticationMethod.ReadWrite.All|Not available.| diff --git a/api-reference/beta/includes/permissions/newslinkpage-create-permissions.md b/api-reference/beta/includes/permissions/newslinkpage-create-permissions.md index be39d948ab6..08a9b0333f9 100644 --- a/api-reference/beta/includes/permissions/newslinkpage-create-permissions.md +++ b/api-reference/beta/includes/permissions/newslinkpage-create-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|Sites.ReadWrite.All|Not available.| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Sites.ReadWrite.All|Not available.| \ No newline at end of file +|Application|Sites.ReadWrite.All|Not available.| + diff --git a/api-reference/beta/includes/permissions/newslinkpage-list-permissions.md b/api-reference/beta/includes/permissions/newslinkpage-list-permissions.md index e5e2ccac2f0..71c1c73863f 100644 --- a/api-reference/beta/includes/permissions/newslinkpage-list-permissions.md +++ b/api-reference/beta/includes/permissions/newslinkpage-list-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|Sites.Read.All|Sites.ReadWrite.All| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Sites.Read.All|Sites.ReadWrite.All| \ No newline at end of file +|Application|Sites.Read.All|Sites.ReadWrite.All| + diff --git a/api-reference/beta/includes/permissions/onlinemeeting-delete-2-permissions.md b/api-reference/beta/includes/permissions/onlinemeeting-delete-2-permissions.md index d844cc38cc5..1aadd70309d 100644 --- a/api-reference/beta/includes/permissions/onlinemeeting-delete-2-permissions.md +++ b/api-reference/beta/includes/permissions/onlinemeeting-delete-2-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetings.ReadWrite|Not available.| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|OnlineMeetings.ReadWrite.All|Not available.| \ No newline at end of file +|Application|OnlineMeetings.ReadWrite.All|Not available.| + diff --git a/api-reference/beta/includes/permissions/onlinemeeting-delete-permissions.md b/api-reference/beta/includes/permissions/onlinemeeting-delete-permissions.md index 23fb3ba2aea..74b203496ea 100644 --- a/api-reference/beta/includes/permissions/onlinemeeting-delete-permissions.md +++ b/api-reference/beta/includes/permissions/onlinemeeting-delete-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetings.ReadWrite|Not available.| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Not supported.|Not supported.| \ No newline at end of file +|Application|Not supported.|Not supported.| + diff --git a/api-reference/beta/includes/permissions/onlinemeeting-get-2-permissions.md b/api-reference/beta/includes/permissions/onlinemeeting-get-2-permissions.md index be4c2d3adb3..c8b8ee98c64 100644 --- a/api-reference/beta/includes/permissions/onlinemeeting-get-2-permissions.md +++ b/api-reference/beta/includes/permissions/onlinemeeting-get-2-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetings.Read|OnlineMeetings.ReadWrite| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|OnlineMeetings.Read.All|OnlineMeetings.ReadWrite.All| \ No newline at end of file +|Application|OnlineMeetings.Read.All|OnlineMeetings.ReadWrite.All| + diff --git a/api-reference/beta/includes/permissions/onlinemeeting-get-3-permissions.md b/api-reference/beta/includes/permissions/onlinemeeting-get-3-permissions.md index b59d3a08a40..ef9bd893115 100644 --- a/api-reference/beta/includes/permissions/onlinemeeting-get-3-permissions.md +++ b/api-reference/beta/includes/permissions/onlinemeeting-get-3-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetingArtifact.Read.All|Not available.| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|OnlineMeetingArtifact.Read.All|Not available.| \ No newline at end of file +|Application|OnlineMeetingArtifact.Read.All|Not available.| + diff --git a/api-reference/beta/includes/permissions/onlinemeeting-get-4-permissions.md b/api-reference/beta/includes/permissions/onlinemeeting-get-4-permissions.md index 3aa1502dace..ae259f1fc8a 100644 --- a/api-reference/beta/includes/permissions/onlinemeeting-get-4-permissions.md +++ b/api-reference/beta/includes/permissions/onlinemeeting-get-4-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetingArtifact.Read.All|OnlineMeetings.Read, OnlineMeetings.ReadWrite| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|OnlineMeetingArtifact.Read.All|Not available.| \ No newline at end of file +|Application|OnlineMeetingArtifact.Read.All|Not available.| + diff --git a/api-reference/beta/includes/permissions/onlinemeeting-get-5-permissions.md b/api-reference/beta/includes/permissions/onlinemeeting-get-5-permissions.md index bdfdd7b59b5..3daea55677e 100644 --- a/api-reference/beta/includes/permissions/onlinemeeting-get-5-permissions.md +++ b/api-reference/beta/includes/permissions/onlinemeeting-get-5-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetingArtifact.Read.All|OnlineMeetings.Read, OnlineMeetings.ReadWrite| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|OnlineMeetingArtifact.Read.All|OnlineMeetings.Read.All, OnlineMeetings.ReadWrite.All| \ No newline at end of file +|Application|OnlineMeetingArtifact.Read.All|OnlineMeetings.Read.All, OnlineMeetings.ReadWrite.All| + diff --git a/api-reference/beta/includes/permissions/onlinemeeting-get-permissions.md b/api-reference/beta/includes/permissions/onlinemeeting-get-permissions.md index 3033fc30672..6bcf69e1319 100644 --- a/api-reference/beta/includes/permissions/onlinemeeting-get-permissions.md +++ b/api-reference/beta/includes/permissions/onlinemeeting-get-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetings.Read|OnlineMeetings.ReadWrite| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Not supported.|Not supported.| \ No newline at end of file +|Application|Not supported.|Not supported.| + diff --git a/api-reference/beta/includes/permissions/onlinemeeting-update-2-permissions.md b/api-reference/beta/includes/permissions/onlinemeeting-update-2-permissions.md index d844cc38cc5..1aadd70309d 100644 --- a/api-reference/beta/includes/permissions/onlinemeeting-update-2-permissions.md +++ b/api-reference/beta/includes/permissions/onlinemeeting-update-2-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetings.ReadWrite|Not available.| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|OnlineMeetings.ReadWrite.All|Not available.| \ No newline at end of file +|Application|OnlineMeetings.ReadWrite.All|Not available.| + diff --git a/api-reference/beta/includes/permissions/onlinemeeting-update-permissions.md b/api-reference/beta/includes/permissions/onlinemeeting-update-permissions.md index 23fb3ba2aea..74b203496ea 100644 --- a/api-reference/beta/includes/permissions/onlinemeeting-update-permissions.md +++ b/api-reference/beta/includes/permissions/onlinemeeting-update-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetings.ReadWrite|Not available.| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Not supported.|Not supported.| \ No newline at end of file +|Application|Not supported.|Not supported.| + diff --git a/api-reference/beta/includes/permissions/sitepage-createfromtemplate-permissions.md b/api-reference/beta/includes/permissions/sitepage-createfromtemplate-permissions.md index 08a9b0333f9..0ad40cf6cbf 100644 --- a/api-reference/beta/includes/permissions/sitepage-createfromtemplate-permissions.md +++ b/api-reference/beta/includes/permissions/sitepage-createfromtemplate-permissions.md @@ -6,7 +6,7 @@ ms.localizationpriority: medium |Permission type|Least privileged permissions|Higher privileged permissions| |:---|:---|:---| -|Delegated (work or school account)|Sites.ReadWrite.All|Not available.| +|Delegated (work or school account)|Sites.ReadWrite.All|Sites.FullControl.All, Sites.Manage.All| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Sites.ReadWrite.All|Not available.| +|Application|Sites.ReadWrite.All|Sites.FullControl.All, Sites.Manage.All| diff --git a/api-reference/v1.0/includes/permissions/application-post-onlinemeetings-2-permissions.md b/api-reference/v1.0/includes/permissions/application-post-onlinemeetings-2-permissions.md index d844cc38cc5..1aadd70309d 100644 --- a/api-reference/v1.0/includes/permissions/application-post-onlinemeetings-2-permissions.md +++ b/api-reference/v1.0/includes/permissions/application-post-onlinemeetings-2-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetings.ReadWrite|Not available.| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|OnlineMeetings.ReadWrite.All|Not available.| \ No newline at end of file +|Application|OnlineMeetings.ReadWrite.All|Not available.| + diff --git a/api-reference/v1.0/includes/permissions/application-post-onlinemeetings-permissions.md b/api-reference/v1.0/includes/permissions/application-post-onlinemeetings-permissions.md index 23fb3ba2aea..74b203496ea 100644 --- a/api-reference/v1.0/includes/permissions/application-post-onlinemeetings-permissions.md +++ b/api-reference/v1.0/includes/permissions/application-post-onlinemeetings-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetings.ReadWrite|Not available.| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Not supported.|Not supported.| \ No newline at end of file +|Application|Not supported.|Not supported.| + diff --git a/api-reference/v1.0/includes/permissions/emailauthenticationmethod-get-permissions.md b/api-reference/v1.0/includes/permissions/emailauthenticationmethod-get-permissions.md index 26753cbc132..1c35de4bc1f 100644 --- a/api-reference/v1.0/includes/permissions/emailauthenticationmethod-get-permissions.md +++ b/api-reference/v1.0/includes/permissions/emailauthenticationmethod-get-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|UserAuthenticationMethod.Read|UserAuthenticationMethod.ReadWrite, UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Not supported.|Not supported.| \ No newline at end of file +|Application|UserAuthenticationMethod.Read.All|UserAuthenticationMethod.ReadWrite.All| + diff --git a/api-reference/v1.0/includes/permissions/onlinemeeting-delete-2-permissions.md b/api-reference/v1.0/includes/permissions/onlinemeeting-delete-2-permissions.md index d844cc38cc5..1aadd70309d 100644 --- a/api-reference/v1.0/includes/permissions/onlinemeeting-delete-2-permissions.md +++ b/api-reference/v1.0/includes/permissions/onlinemeeting-delete-2-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetings.ReadWrite|Not available.| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|OnlineMeetings.ReadWrite.All|Not available.| \ No newline at end of file +|Application|OnlineMeetings.ReadWrite.All|Not available.| + diff --git a/api-reference/v1.0/includes/permissions/onlinemeeting-delete-permissions.md b/api-reference/v1.0/includes/permissions/onlinemeeting-delete-permissions.md index 23fb3ba2aea..74b203496ea 100644 --- a/api-reference/v1.0/includes/permissions/onlinemeeting-delete-permissions.md +++ b/api-reference/v1.0/includes/permissions/onlinemeeting-delete-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetings.ReadWrite|Not available.| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Not supported.|Not supported.| \ No newline at end of file +|Application|Not supported.|Not supported.| + diff --git a/api-reference/v1.0/includes/permissions/onlinemeeting-get-2-permissions.md b/api-reference/v1.0/includes/permissions/onlinemeeting-get-2-permissions.md index be4c2d3adb3..c8b8ee98c64 100644 --- a/api-reference/v1.0/includes/permissions/onlinemeeting-get-2-permissions.md +++ b/api-reference/v1.0/includes/permissions/onlinemeeting-get-2-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetings.Read|OnlineMeetings.ReadWrite| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|OnlineMeetings.Read.All|OnlineMeetings.ReadWrite.All| \ No newline at end of file +|Application|OnlineMeetings.Read.All|OnlineMeetings.ReadWrite.All| + diff --git a/api-reference/v1.0/includes/permissions/onlinemeeting-get-3-permissions.md b/api-reference/v1.0/includes/permissions/onlinemeeting-get-3-permissions.md index b59d3a08a40..ef9bd893115 100644 --- a/api-reference/v1.0/includes/permissions/onlinemeeting-get-3-permissions.md +++ b/api-reference/v1.0/includes/permissions/onlinemeeting-get-3-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetingArtifact.Read.All|Not available.| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|OnlineMeetingArtifact.Read.All|Not available.| \ No newline at end of file +|Application|OnlineMeetingArtifact.Read.All|Not available.| + diff --git a/api-reference/v1.0/includes/permissions/onlinemeeting-get-4-permissions.md b/api-reference/v1.0/includes/permissions/onlinemeeting-get-4-permissions.md index 3aa1502dace..ae259f1fc8a 100644 --- a/api-reference/v1.0/includes/permissions/onlinemeeting-get-4-permissions.md +++ b/api-reference/v1.0/includes/permissions/onlinemeeting-get-4-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetingArtifact.Read.All|OnlineMeetings.Read, OnlineMeetings.ReadWrite| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|OnlineMeetingArtifact.Read.All|Not available.| \ No newline at end of file +|Application|OnlineMeetingArtifact.Read.All|Not available.| + diff --git a/api-reference/v1.0/includes/permissions/onlinemeeting-get-5-permissions.md b/api-reference/v1.0/includes/permissions/onlinemeeting-get-5-permissions.md index bdfdd7b59b5..3daea55677e 100644 --- a/api-reference/v1.0/includes/permissions/onlinemeeting-get-5-permissions.md +++ b/api-reference/v1.0/includes/permissions/onlinemeeting-get-5-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetingArtifact.Read.All|OnlineMeetings.Read, OnlineMeetings.ReadWrite| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|OnlineMeetingArtifact.Read.All|OnlineMeetings.Read.All, OnlineMeetings.ReadWrite.All| \ No newline at end of file +|Application|OnlineMeetingArtifact.Read.All|OnlineMeetings.Read.All, OnlineMeetings.ReadWrite.All| + diff --git a/api-reference/v1.0/includes/permissions/onlinemeeting-get-permissions.md b/api-reference/v1.0/includes/permissions/onlinemeeting-get-permissions.md index 3033fc30672..6bcf69e1319 100644 --- a/api-reference/v1.0/includes/permissions/onlinemeeting-get-permissions.md +++ b/api-reference/v1.0/includes/permissions/onlinemeeting-get-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetings.Read|OnlineMeetings.ReadWrite| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Not supported.|Not supported.| \ No newline at end of file +|Application|Not supported.|Not supported.| + diff --git a/api-reference/v1.0/includes/permissions/onlinemeeting-update-2-permissions.md b/api-reference/v1.0/includes/permissions/onlinemeeting-update-2-permissions.md index d844cc38cc5..1aadd70309d 100644 --- a/api-reference/v1.0/includes/permissions/onlinemeeting-update-2-permissions.md +++ b/api-reference/v1.0/includes/permissions/onlinemeeting-update-2-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetings.ReadWrite|Not available.| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|OnlineMeetings.ReadWrite.All|Not available.| \ No newline at end of file +|Application|OnlineMeetings.ReadWrite.All|Not available.| + diff --git a/api-reference/v1.0/includes/permissions/onlinemeeting-update-permissions.md b/api-reference/v1.0/includes/permissions/onlinemeeting-update-permissions.md index 23fb3ba2aea..74b203496ea 100644 --- a/api-reference/v1.0/includes/permissions/onlinemeeting-update-permissions.md +++ b/api-reference/v1.0/includes/permissions/onlinemeeting-update-permissions.md @@ -8,4 +8,5 @@ ms.localizationpriority: medium |:---|:---|:---| |Delegated (work or school account)|OnlineMeetings.ReadWrite|Not available.| |Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Not supported.|Not supported.| \ No newline at end of file +|Application|Not supported.|Not supported.| + From 59496de35dd412125e30cf70cc518239d391d049 Mon Sep 17 00:00:00 2001 From: Faith Moraa Ombongi Date: Wed, 4 Dec 2024 13:12:18 +0300 Subject: [PATCH 120/144] Update employeeexperience-post-learningproviders.md - document least privileged role, GA burndown --- .../beta/api/employeeexperience-post-learningproviders.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/employeeexperience-post-learningproviders.md b/api-reference/beta/api/employeeexperience-post-learningproviders.md index e70d621258f..30fcd1827af 100644 --- a/api-reference/beta/api/employeeexperience-post-learningproviders.md +++ b/api-reference/beta/api/employeeexperience-post-learningproviders.md @@ -23,8 +23,8 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/employeeexperience-post-learningproviders-permissions.md)] > **Note:** The following are required for the user: -> - Viva Suite or Viva Learning license -> - Global admin, knowledge admin role +> - Viva Suite or Viva Learning license. +> - A supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json), where Knowledge Administrator is the least privileged supported role. ## HTTP request From c8dbd69bfab0d7dc14c08334f0d01c101dd2e6a6 Mon Sep 17 00:00:00 2001 From: Faith Moraa Ombongi Date: Wed, 4 Dec 2024 13:13:53 +0300 Subject: [PATCH 121/144] Update employeeexperience-post-learningproviders.md - GA burndown; Knowledge Admin is the least privileged role --- .../v1.0/api/employeeexperience-post-learningproviders.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/employeeexperience-post-learningproviders.md b/api-reference/v1.0/api/employeeexperience-post-learningproviders.md index 9612353a234..b3fb2794c91 100644 --- a/api-reference/v1.0/api/employeeexperience-post-learningproviders.md +++ b/api-reference/v1.0/api/employeeexperience-post-learningproviders.md @@ -25,7 +25,7 @@ Choose the permission or permissions marked as least privileged for this API. Us > **Note:** The following are required for the user: > - Viva Suite or Viva Learning license -> - Global admin, knowledge admin role +> - A supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json), where Knowledge Administrator is the least privileged supported role. ## HTTP request From 455770ffef67aa96d4d7fb539dec274431b66c70 Mon Sep 17 00:00:00 2001 From: Faith Moraa Ombongi Date: Wed, 4 Dec 2024 13:17:32 +0300 Subject: [PATCH 122/144] Update employeeexperience-post-learningproviders.md --- .../v1.0/api/employeeexperience-post-learningproviders.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/employeeexperience-post-learningproviders.md b/api-reference/v1.0/api/employeeexperience-post-learningproviders.md index b3fb2794c91..93df6b813f3 100644 --- a/api-reference/v1.0/api/employeeexperience-post-learningproviders.md +++ b/api-reference/v1.0/api/employeeexperience-post-learningproviders.md @@ -24,7 +24,7 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/employeeexperience-post-learningproviders-permissions.md)] > **Note:** The following are required for the user: -> - Viva Suite or Viva Learning license +> - Viva Suite or Viva Learning license. > - A supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json), where Knowledge Administrator is the least privileged supported role. ## HTTP request From f95fe264e7d28949cc94109d3e3f7cf980bb072c Mon Sep 17 00:00:00 2001 From: Faith Moraa Ombongi Date: Wed, 4 Dec 2024 13:27:21 +0300 Subject: [PATCH 123/144] Update employeeexperience-post-learningproviders.md - add ms.date --- .../beta/api/employeeexperience-post-learningproviders.md | 1 + 1 file changed, 1 insertion(+) diff --git a/api-reference/beta/api/employeeexperience-post-learningproviders.md b/api-reference/beta/api/employeeexperience-post-learningproviders.md index 30fcd1827af..0fb1f11ba46 100644 --- a/api-reference/beta/api/employeeexperience-post-learningproviders.md +++ b/api-reference/beta/api/employeeexperience-post-learningproviders.md @@ -5,6 +5,7 @@ author: "malabikaroy" ms.localizationpriority: medium ms.subservice: "viva-learning" doc_type: apiPageType +ms.date: 12/04/2024 --- # Create learningProvider From 073dc5eca6d3928196b6b1b25e8d762b57449d03 Mon Sep 17 00:00:00 2001 From: Microsoft Graph DevX Tooling Date: Wed, 4 Dec 2024 11:05:55 +0000 Subject: [PATCH 124/144] Update reference TOC --- api-reference/beta/toc/security/toc.yml | 12 ++++++------ api-reference/v1.0/toc/security/toc.yml | 14 +++++++------- 2 files changed, 13 insertions(+), 13 deletions(-) diff --git a/api-reference/beta/toc/security/toc.yml b/api-reference/beta/toc/security/toc.yml index 945d6e7b2b7..12ed0c962d8 100644 --- a/api-reference/beta/toc/security/toc.yml +++ b/api-reference/beta/toc/security/toc.yml @@ -460,21 +460,21 @@ items: items: - name: eDiscovery review set href: ../../resources/security-ediscoveryreviewset.md - - name: List ediscoveryReviewSets + - name: List href: ../../api/security-ediscoverycase-list-reviewsets.md - - name: Create ediscoveryReviewSet + - name: Create href: ../../api/security-ediscoverycase-post-reviewsets.md - - name: Get ediscoveryReviewSet + - name: Get href: ../../api/security-ediscoveryreviewset-get.md - - name: export + - name: Export href: ../../api/security-ediscoveryreviewset-export.md - - name: addToReviewSet + - name: Add to review set href: ../../api/security-ediscoveryreviewset-addtoreviewset.md - name: List files href: ../../api/security-ediscoveryreviewset-list-files.md - name: List queries href: ../../api/security-ediscoveryreviewset-list-queries.md - - name: Create ediscoveryReviewSetQuery + - name: Create review set query href: ../../api/security-ediscoveryreviewset-post-queries.md - name: eDiscovery review tag items: diff --git a/api-reference/v1.0/toc/security/toc.yml b/api-reference/v1.0/toc/security/toc.yml index f91cb111989..72bb276eea6 100644 --- a/api-reference/v1.0/toc/security/toc.yml +++ b/api-reference/v1.0/toc/security/toc.yml @@ -352,20 +352,20 @@ items: items: - name: eDiscovery review set href: ../../resources/security-ediscoveryreviewset.md - - name: List ediscoveryReviewSets + - name: List href: ../../api/security-ediscoverycase-list-reviewsets.md - - name: Create ediscoveryReviewSet + - name: Create href: ../../api/security-ediscoverycase-post-reviewsets.md - - name: Get ediscoveryReviewSet + - name: Get href: ../../api/security-ediscoveryreviewset-get.md - - name: addToReviewSet + - name: Export + href: ../../api/security-ediscoveryreviewset-export.md + - name: Add to review set href: ../../api/security-ediscoveryreviewset-addtoreviewset.md - name: List queries href: ../../api/security-ediscoveryreviewset-list-queries.md - - name: Create ediscoveryReviewSetQuery + - name: Create review set query href: ../../api/security-ediscoveryreviewset-post-queries.md - - name: export - href: ../../api/security-ediscoveryreviewset-export.md - name: eDiscovery review tag items: - name: eDiscovery review tag From e2acba3aa6fb19f35d5f4ca54dbe307b50b8d78a Mon Sep 17 00:00:00 2001 From: Faith Moraa Ombongi Date: Wed, 4 Dec 2024 19:26:57 +0300 Subject: [PATCH 125/144] Update claimsmappingpolicy.md --- api-reference/v1.0/resources/claimsmappingpolicy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/resources/claimsmappingpolicy.md b/api-reference/v1.0/resources/claimsmappingpolicy.md index 600014447a9..70c83efbc4f 100644 --- a/api-reference/v1.0/resources/claimsmappingpolicy.md +++ b/api-reference/v1.0/resources/claimsmappingpolicy.md @@ -18,7 +18,7 @@ Represents the claim-mapping policies for WS-Fed, SAML, OAuth 2.0, and OpenID Co - Create claim types that do not already exist - Choose or change the source of data emitted in specific claims -The number of claims and transformations that can be added to a claims-mapping policy are limited to reduce token size. Any claims schema entries or transformations that are encountered after the limit has been reached are ignored and included in the issued token. For more information about the limits, see [Properties of a claims-mapping policy definition](#properties-of-a-claims-mapping-policy-definition) +The number of claims and transformations that can be added to a claims-mapping policy are limited to reduce token size. Any claims schema entries or transformations that are encountered after the limit has been reached are ignored and not included in the issued token. For more information about the limits, see [Properties of a claims-mapping policy definition](#properties-of-a-claims-mapping-policy-definition) For more scenario and configuration details, see [Claims mapping policy type](/azure/active-directory/develop/reference-claims-mapping-policy-type) and [How to: Customize claims emitted in tokens for a specific app in a tenant](/azure/active-directory/develop/active-directory-claims-mapping#claims-mapping-policy-properties). From 3697d57682fec18a0c6350b1044e31600c8c601d Mon Sep 17 00:00:00 2001 From: Faith Moraa Ombongi Date: Wed, 4 Dec 2024 19:29:13 +0300 Subject: [PATCH 126/144] Fix typo in claims-mapping policy documentation --- api-reference/beta/resources/claimsmappingpolicy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/beta/resources/claimsmappingpolicy.md b/api-reference/beta/resources/claimsmappingpolicy.md index 3c5104be38d..25faf52f808 100644 --- a/api-reference/beta/resources/claimsmappingpolicy.md +++ b/api-reference/beta/resources/claimsmappingpolicy.md @@ -19,7 +19,7 @@ Represents the claim-mapping policies for WS-Fed, SAML, OAuth 2.0, and OpenID Co - Create claim types that don't already exist - Choose or change the source of data emitted in specific claims -The number of claims and transformations that can be added to a claims-mapping policy are limited to reduce token size. Any claims schema entries or transformations that are encountered after the limit has been reached are ignored and included in the issued token. For more information about the limits, see [Properties of a claims-mapping policy definition](#properties-of-a-claims-mapping-policy-definition) +The number of claims and transformations that can be added to a claims-mapping policy are limited to reduce token size. Any claims schema entries or transformations that are encountered after the limit has been reached are ignored and not included in the issued token. For more information about the limits, see [Properties of a claims-mapping policy definition](#properties-of-a-claims-mapping-policy-definition) For more scenario and configuration details, see [Claims mapping policy type](/azure/active-directory/develop/reference-claims-mapping-policy-type) and [How to: Customize claims emitted in tokens for a specific app in a tenant](/azure/active-directory/develop/active-directory-claims-mapping#claims-mapping-policy-properties). From 79d372c3387c96a64da17a09fe0772ed0100c785 Mon Sep 17 00:00:00 2001 From: Faith Moraa Ombongi Date: Wed, 4 Dec 2024 20:44:20 +0300 Subject: [PATCH 127/144] Update claimsmappingpolicy.md --- api-reference/beta/resources/claimsmappingpolicy.md | 1 + 1 file changed, 1 insertion(+) diff --git a/api-reference/beta/resources/claimsmappingpolicy.md b/api-reference/beta/resources/claimsmappingpolicy.md index 25faf52f808..8a1cd6d0c54 100644 --- a/api-reference/beta/resources/claimsmappingpolicy.md +++ b/api-reference/beta/resources/claimsmappingpolicy.md @@ -5,6 +5,7 @@ ms.localizationpriority: medium author: "paulgarn" ms.subservice: "entra-sign-in" doc_type: "resourcePageType" +ms.date: 12/04/2024 --- # claimsMappingPolicy resource type From d3eb28fac40f0dd29f74e41e6aa87496a13a5dee Mon Sep 17 00:00:00 2001 From: Faith Moraa Ombongi Date: Wed, 4 Dec 2024 21:17:23 +0300 Subject: [PATCH 128/144] Update ClaimsSchema definition links --- api-reference/beta/resources/claimsmappingpolicy.md | 2 +- api-reference/v1.0/resources/claimsmappingpolicy.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/resources/claimsmappingpolicy.md b/api-reference/beta/resources/claimsmappingpolicy.md index 8a1cd6d0c54..70e2f4f687e 100644 --- a/api-reference/beta/resources/claimsmappingpolicy.md +++ b/api-reference/beta/resources/claimsmappingpolicy.md @@ -87,7 +87,7 @@ The JSON object to be inserted into the **definition** property must first be ** |:---------------|:--------|:----------| |Version|Integer|Set value of 1. Required.| |IncludeBasicClaimSet|Boolean|If set to `true`, all claims in the basic claim set are emitted in tokens affected by the policy. If set to `false`, claims in the basic claim set aren't in the tokens, unless they're individually added in the ClaimsSchema property of the same policy.| -|ClaimsSchema|JSON object|Defines which claims are present in the tokens affected by the policy, in addition to the basic claim set and the core claim set. For each claim schema entry defined in this property, certain information is required. Specify where the data is coming from (Value or Source/ID pair), and which claim the data is emitted as (Claim Type). A maximum of 50 claims are included in the token through the ClaimsSchema object. Any claims schema entries that are encountered after the limit has been reached are ignored and don't appear in the issued token. Further details are available in the [ClaimsSchema definition](/azure/active-directory/develop/active-directory-claims-mapping#claims-schema).| +|ClaimsSchema|JSON object|Defines which claims are present in the tokens affected by the policy, in addition to the basic claim set and the core claim set. For each claim schema entry defined in this property, certain information is required. Specify where the data is coming from (Value or Source/ID pair), and which claim the data is emitted as (Claim Type). A maximum of 50 claims are included in the token through the ClaimsSchema object. Any claims schema entries that are encountered after the limit has been reached are ignored and don't appear in the issued token. Further details are available in the [ClaimsSchema definition](/entra/identity-platform/saml-claims-customization).| |ClaimsTransformation|JSON object| Defines common transformations that can be applied to source data, to generate the output data for claims specified in the ClaimsSchema. A maximum of 50 transformations are included in the token through the ClaimsTransformation object. Any transformations that are encountered after the limit has been reached are ignored and don't appear in the issued token. For more information about ClaimsTransformation and the supported functions, see [Claims transformation](/azure/active-directory/develop/active-directory-claims-mapping#claims-transformation).| diff --git a/api-reference/v1.0/resources/claimsmappingpolicy.md b/api-reference/v1.0/resources/claimsmappingpolicy.md index 70c83efbc4f..0d2c1c7ebcc 100644 --- a/api-reference/v1.0/resources/claimsmappingpolicy.md +++ b/api-reference/v1.0/resources/claimsmappingpolicy.md @@ -81,7 +81,7 @@ The JSON object to be inserted into the **definition** property must first be ** | Property | Type |Description| |:---------------|:--------|:----------| -|ClaimsSchema|JSON object|Defines which claims are present in the tokens affected by the policy, in addition to the basic claim set and the core claim set. For each claim schema entry defined in this property, certain information is required. Specify where the data is coming from (Value or Source/ID pair), and which claim the data is emitted as (Claim Type). A maximum of 50 claims are included in the token through the ClaimsSchema object. Any claims schema entries that are encountered after the limit has been reached will be ignored and will not appear in the issued token. Further details are available in the [ClaimsSchema definition](/azure/active-directory/develop/active-directory-claims-mapping#claims-schema).| +|ClaimsSchema|JSON object|Defines which claims are present in the tokens affected by the policy, in addition to the basic claim set and the core claim set. For each claim schema entry defined in this property, certain information is required. Specify where the data is coming from (Value or Source/ID pair), and which claim the data is emitted as (Claim Type). A maximum of 50 claims are included in the token through the ClaimsSchema object. Any claims schema entries that are encountered after the limit has been reached will be ignored and will not appear in the issued token. Further details are available in the [ClaimsSchema definition](/entra/identity-platform/saml-claims-customization).| |ClaimsTransformation|JSON object| Defines common transformations that can be applied to source data, to generate the output data for claims specified in the ClaimsSchema. A maximum of 50 transformations are included in the token through the ClaimsTransformation object. Any transformations that are encountered after the limit has been reached will be ignored and will not appear in the issued token. For more information about ClaimsTransformation and the supported functions, see [Claims transformation](/azure/active-directory/develop/active-directory-claims-mapping#claims-transformation).| |IncludeBasicClaimSet|Boolean|If set to `true`, all claims in the basic claim set are emitted in tokens affected by the policy. If set to `false`, claims in the basic claim set are not in the tokens, unless they are individually added in the ClaimsSchema property of the same policy.| |Version|Integer|Set value of 1. Required.| From f54ed321cde5e8089da64d4539571f7d99f1cd88 Mon Sep 17 00:00:00 2001 From: Vincent Biret Date: Wed, 4 Dec 2024 14:14:04 -0500 Subject: [PATCH 129/144] fix: removes extraneous beta disclamer --- .../resources/authenticationmethods-usage-insights-overview.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/api-reference/v1.0/resources/authenticationmethods-usage-insights-overview.md b/api-reference/v1.0/resources/authenticationmethods-usage-insights-overview.md index 292ec15a53a..dea923d44f2 100644 --- a/api-reference/v1.0/resources/authenticationmethods-usage-insights-overview.md +++ b/api-reference/v1.0/resources/authenticationmethods-usage-insights-overview.md @@ -12,8 +12,6 @@ ms.date: 01/18/2024 Namespace: microsoft.graph -[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - The authentication methods usage reports help you understand how users in your organization are using [Microsoft Entra authentication capabilities](../resources/authenticationmethods-overview.md) such as multifactor authentication (MFA), Self-Service Password Reset (SSPR), and Passwordless authentication. These reports provide information such as: From 5d8c072839c65ac6c54d5ffaf074f6226baafee2 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 4 Dec 2024 21:17:00 +0100 Subject: [PATCH 130/144] Update workforceintegration.md --- api-reference/v1.0/resources/workforceintegration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/resources/workforceintegration.md b/api-reference/v1.0/resources/workforceintegration.md index 859bc620bd0..49adc604fba 100644 --- a/api-reference/v1.0/resources/workforceintegration.md +++ b/api-reference/v1.0/resources/workforceintegration.md @@ -29,7 +29,7 @@ Represents an instance of a workforce integration with shifts. | Property | Type | Description | |:-------------|:------------|:------------| |apiVersion|Int32|API version for the call back URL. Start with 1.| -|createdDateTime|DateTimeOffset|The timestamp on which this **WorkforceIntegration** was first created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [changeTrackedEntity](../resources/changetrackedentity.md).| +|createdDateTime|DateTimeOffset|The timestamp on which this **WorkforceIntegration** was first created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [changeTrackedEntity](../resources/changetrackedentity.md).| |displayName|String|Name of the workforce integration.| |eligibilityFilteringEnabledEntities|eligibilityFilteringEnabledEntities| Support to view eligibility-filtered results. Possible values are: `none`, `swapRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason`.| |encryption|[workforceIntegrationEncryption](workforceintegrationencryption.md)|The workforce integration encryption resource.| From 0590fd8a0fd2fa2c299f59aa3893b4f1f0ec9936 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 4 Dec 2024 21:19:11 +0100 Subject: [PATCH 131/144] Update schedule-post-timesoff.md --- api-reference/v1.0/api/schedule-post-timesoff.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/schedule-post-timesoff.md b/api-reference/v1.0/api/schedule-post-timesoff.md index 051cd602740..addec28070b 100644 --- a/api-reference/v1.0/api/schedule-post-timesoff.md +++ b/api-reference/v1.0/api/schedule-post-timesoff.md @@ -45,7 +45,7 @@ POST /teams/{teamId}/schedule/timesOff In the request body, supply a JSON representation of the modified [timeOff](../resources/timeoff.md) object. -The following table lists the properties that you can use when you create an **TimeOff** object. +The following table lists the properties that you can use when you create an **timeOff** object. |Property|Type|Description| From d4706cde208b82a468d8106223640067ece9f525 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 4 Dec 2024 21:20:55 +0100 Subject: [PATCH 132/144] Update workforceintegration-post.md --- api-reference/v1.0/api/workforceintegration-post.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/api-reference/v1.0/api/workforceintegration-post.md b/api-reference/v1.0/api/workforceintegration-post.md index 5747e6f8dbf..f45b4e7fc50 100644 --- a/api-reference/v1.0/api/workforceintegration-post.md +++ b/api-reference/v1.0/api/workforceintegration-post.md @@ -46,9 +46,7 @@ POST /teamwork/workforceIntegrations In the request body, supply a JSON representation of the [workforceIntegration](../resources/workforceintegration.md) object. -Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed. - -The following table lists the properties that you can use when you create an **WorkforceIntegration** object. +The following table lists the properties that you can use when you create an **workforceIntegration** object. | Property | Type | Description | |:-------------|:------------|:------------| From b16ad65a1454bad2672a530fbbbbb291efaafad8 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 4 Dec 2024 21:23:02 +0100 Subject: [PATCH 133/144] Update workforceintegration-post.md --- api-reference/v1.0/api/workforceintegration-post.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/workforceintegration-post.md b/api-reference/v1.0/api/workforceintegration-post.md index f45b4e7fc50..3f022c75171 100644 --- a/api-reference/v1.0/api/workforceintegration-post.md +++ b/api-reference/v1.0/api/workforceintegration-post.md @@ -55,7 +55,7 @@ The following table lists the properties that you can use when you create an **w |eligibilityFilteringEnabledEntities|eligibilityFilteringEnabledEntities| Support to view eligibility-filtered results. Possible values are: `none`, `swapRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason`.| |encryption|[workforceIntegrationEncryption](../resources/workforceintegrationencryption.md)|The workforce integration encryption resource.| |isActive|Boolean|Indicates whether this workforce integration is currently active and available.| -|supportedEntities|workforceIntegrationSupportedEntities | The Shifts entities supported for synchronous change notifications. Shifts make a call back to the URL provided on client changes on those entities added here. By default, no entities are supported for change notifications. Possible values are: `none`, `shift`, `swapRequest`, `userShiftPreferences`, `openShift`, `openShiftRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`, `timeOff`, `timeOffRequest`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason` , `timeOff` , `timeOffRequest`.| +|supportedEntities|workforceIntegrationSupportedEntities | The Shifts entities supported for synchronous change notifications. Shifts call back to the provided URL when client changes occur to the entities specified in this property. By default, no entities are supported for change notifications. Possible values are: `none`, `shift`, `swapRequest`, `userShiftPreferences`, `openShift`, `openShiftRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`, `timeOff`, `timeOffRequest`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason` , `timeOff` , `timeOffRequest`.| |url|String| Workforce integration URL used for callbacks from the Shifts service.| ## Response From ca7b02f9b57d308eb95b893b9cde7eb41022b569 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 4 Dec 2024 21:23:43 +0100 Subject: [PATCH 134/144] Update workforceintegration-update.md --- api-reference/v1.0/api/workforceintegration-update.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/workforceintegration-update.md b/api-reference/v1.0/api/workforceintegration-update.md index a2a90e51506..7987c1d21d7 100644 --- a/api-reference/v1.0/api/workforceintegration-update.md +++ b/api-reference/v1.0/api/workforceintegration-update.md @@ -51,7 +51,7 @@ PATCH /teamwork/workforceIntegrations/{workforceIntegrationId} |eligibilityFilteringEnabledEntities|eligibilityFilteringEnabledEntities| Support to view eligibility-filtered results. Possible values are: `none`, `swapRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason`.| |encryption|[workforceIntegrationEncryption](../resources/workforceintegrationencryption.md)|The workforce integration encryption resource.| |isActive|Boolean|Indicates whether this workforce integration is currently active and available.| -|supportedEntities|workforceIntegrationSupportedEntities | The Shifts entities supported for synchronous change notifications. Shifts will make a call back to the url provided on client changes on those entities added here. By default, no entities are supported for change notifications. Possible values are: `none`, `shift`, `swapRequest`, `userShiftPreferences`, `openShift`, `openShiftRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`, `timeOff`, `timeOffRequest`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason` , `timeOff` , `timeOffRequest`.| +|supportedEntities|workforceIntegrationSupportedEntities | The Shifts entities supported for synchronous change notifications. Shifts call back to the provided URL when client changes occur to the entities specified in this property. Possible values are: `none`, `shift`, `swapRequest`, `userShiftPreferences`, `openShift`, `openShiftRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`, `timeOff`, `timeOffRequest`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason` , `timeOff` , `timeOffRequest`.| |url|String| Workforce integration URL for callbacks from the Shifts service.| ## Response From 2e707f4b5585d60c33da8b536cf718d337b9966b Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 4 Dec 2024 21:26:48 +0100 Subject: [PATCH 135/144] Update openshift-update.md --- api-reference/v1.0/api/openshift-update.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/openshift-update.md b/api-reference/v1.0/api/openshift-update.md index 14e52f8aadb..5bc4ceeec3a 100644 --- a/api-reference/v1.0/api/openshift-update.md +++ b/api-reference/v1.0/api/openshift-update.md @@ -52,7 +52,7 @@ PUT /teams/{id}/schedule/openShifts/{openShiftId} ## Response -If successful, this method returns a `200 OK` response code and an updated [openShift](../resources/openshift.md) object in the response body. +If successful, this method returns a `204 No Content` response code and empty content. If the request specifies the `Prefer` header with `return=representation` preference, then this method returns a `200 OK` response code and an updated [openShift](../resources/openshift.md) object in the response body. ## Examples From ba330799d4c2c3bcc13504e344405275fb376803 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 4 Dec 2024 21:45:28 +0100 Subject: [PATCH 136/144] Update schedule-post-shifts.md --- api-reference/v1.0/api/schedule-post-shifts.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/schedule-post-shifts.md b/api-reference/v1.0/api/schedule-post-shifts.md index af367f96a24..7e5b310b5b8 100644 --- a/api-reference/v1.0/api/schedule-post-shifts.md +++ b/api-reference/v1.0/api/schedule-post-shifts.md @@ -45,7 +45,7 @@ POST /teams/{teamId}/schedule/shifts In the request body, supply a JSON representation of the modified [shift](../resources/shift.md) object. -The following table lists the properties that you can use when you create an **Shift** object. +The following table lists the properties that you can use when you create an **shift** object. |Property|Type|Description| |:---|:---|:---| From 844257fd99f09ba80f8494065187f667de962a04 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 4 Dec 2024 21:48:27 +0100 Subject: [PATCH 137/144] Update workforceintegration-post.md --- api-reference/v1.0/api/workforceintegration-post.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/workforceintegration-post.md b/api-reference/v1.0/api/workforceintegration-post.md index 3f022c75171..e8fc0cc4323 100644 --- a/api-reference/v1.0/api/workforceintegration-post.md +++ b/api-reference/v1.0/api/workforceintegration-post.md @@ -46,7 +46,7 @@ POST /teamwork/workforceIntegrations In the request body, supply a JSON representation of the [workforceIntegration](../resources/workforceintegration.md) object. -The following table lists the properties that you can use when you create an **workforceIntegration** object. +The following table lists the properties that you can use when you create a **workforceIntegration** object. | Property | Type | Description | |:-------------|:------------|:------------| From cac32186a38713ade3776f97b5d6d334f83b1a34 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 4 Dec 2024 21:49:59 +0100 Subject: [PATCH 138/144] Update workforceintegration.md --- api-reference/v1.0/resources/workforceintegration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/resources/workforceintegration.md b/api-reference/v1.0/resources/workforceintegration.md index 49adc604fba..084eb56aeab 100644 --- a/api-reference/v1.0/resources/workforceintegration.md +++ b/api-reference/v1.0/resources/workforceintegration.md @@ -29,7 +29,7 @@ Represents an instance of a workforce integration with shifts. | Property | Type | Description | |:-------------|:------------|:------------| |apiVersion|Int32|API version for the call back URL. Start with 1.| -|createdDateTime|DateTimeOffset|The timestamp on which this **WorkforceIntegration** was first created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [changeTrackedEntity](../resources/changetrackedentity.md).| +|createdDateTime|DateTimeOffset|The timestamp on which this **workforceIntegration** was first created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from [changeTrackedEntity](../resources/changetrackedentity.md).| |displayName|String|Name of the workforce integration.| |eligibilityFilteringEnabledEntities|eligibilityFilteringEnabledEntities| Support to view eligibility-filtered results. Possible values are: `none`, `swapRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason`.| |encryption|[workforceIntegrationEncryption](workforceintegrationencryption.md)|The workforce integration encryption resource.| From b5d40e4c0066bf8af5728b8dca47f0d18623136c Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 4 Dec 2024 21:51:13 +0100 Subject: [PATCH 139/144] Update workforceintegration.md --- api-reference/v1.0/resources/workforceintegration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/resources/workforceintegration.md b/api-reference/v1.0/resources/workforceintegration.md index 084eb56aeab..0cdab1644d4 100644 --- a/api-reference/v1.0/resources/workforceintegration.md +++ b/api-reference/v1.0/resources/workforceintegration.md @@ -34,7 +34,7 @@ Represents an instance of a workforce integration with shifts. |eligibilityFilteringEnabledEntities|eligibilityFilteringEnabledEntities| Support to view eligibility-filtered results. Possible values are: `none`, `swapRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason`.| |encryption|[workforceIntegrationEncryption](workforceintegrationencryption.md)|The workforce integration encryption resource.| |isActive|Boolean|Indicates whether this workforce integration is currently active and available.| -|supportedEntities|workforceIntegrationSupportedEntities | The Shifts entities supported for synchronous change notifications. Shifts make a call-back to the URL provided on client changes on those entities added here. By default, no entities are supported for change notifications. Possible values are: `none`, `shift`, `swapRequest`, `userShiftPreferences`, `openShift`, `openShiftRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`, `timeOff`, `timeOffRequest`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason`, `timeOff`, `timeOffRequest`.| +|supportedEntities|workforceIntegrationSupportedEntities | The Shifts entities supported for synchronous change notifications. Shifts call back to the provided URL when client changes occur to the entities specified in this property. By default, no entities are supported for change notifications. Possible values are: `none`, `shift`, `swapRequest`, `userShiftPreferences`, `openShift`, `openShiftRequest`, `offerShiftRequest`, `unknownFutureValue`, `timeOffReason`, `timeOff`, `timeOffRequest`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `timeOffReason`, `timeOff`, `timeOffRequest`.| |url|String| Workforce Integration URL for callbacks from the Shifts service.| ## Relationships From 54023bbd59bd348d8f0ab582bf993402c2428893 Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 4 Dec 2024 21:53:31 +0100 Subject: [PATCH 140/144] Update schedule-post-shifts.md --- api-reference/v1.0/api/schedule-post-shifts.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-reference/v1.0/api/schedule-post-shifts.md b/api-reference/v1.0/api/schedule-post-shifts.md index 7e5b310b5b8..d84ddfcbb8e 100644 --- a/api-reference/v1.0/api/schedule-post-shifts.md +++ b/api-reference/v1.0/api/schedule-post-shifts.md @@ -45,7 +45,7 @@ POST /teams/{teamId}/schedule/shifts In the request body, supply a JSON representation of the modified [shift](../resources/shift.md) object. -The following table lists the properties that you can use when you create an **shift** object. +The following table lists the properties that you can use when you create a **shift** object. |Property|Type|Description| |:---|:---|:---| From 0ae96499aa1a03e10b8f8ddfb45b6ca47f42567f Mon Sep 17 00:00:00 2001 From: Jarbas Horst Date: Wed, 4 Dec 2024 21:54:08 +0100 Subject: [PATCH 141/144] Update schedule-post-timesoff.md --- api-reference/v1.0/api/schedule-post-timesoff.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api-reference/v1.0/api/schedule-post-timesoff.md b/api-reference/v1.0/api/schedule-post-timesoff.md index addec28070b..89c1cdebe18 100644 --- a/api-reference/v1.0/api/schedule-post-timesoff.md +++ b/api-reference/v1.0/api/schedule-post-timesoff.md @@ -23,7 +23,7 @@ Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/schedule-post-timesoff-permissions.md)] -> **Note**: This API supports admin permissions. Users with admin roles can access groups that they are not a member of. +> **Note**: This API supports admin permissions. Users with admin roles can access groups that they aren't a member of. ## HTTP request @@ -45,7 +45,7 @@ POST /teams/{teamId}/schedule/timesOff In the request body, supply a JSON representation of the modified [timeOff](../resources/timeoff.md) object. -The following table lists the properties that you can use when you create an **timeOff** object. +The following table lists the properties that you can use when you create a **timeOff** object. |Property|Type|Description| From cbeca3a4ba604eef68abb88afc93a5875993aaf2 Mon Sep 17 00:00:00 2001 From: Laura Graham Date: Wed, 4 Dec 2024 19:34:37 -0800 Subject: [PATCH 142/144] Update Microsoft.EnhancedRestore.json --- changelog/Microsoft.EnhancedRestore.json | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/changelog/Microsoft.EnhancedRestore.json b/changelog/Microsoft.EnhancedRestore.json index 623aff70a24..f695f170048 100644 --- a/changelog/Microsoft.EnhancedRestore.json +++ b/changelog/Microsoft.EnhancedRestore.json @@ -46,9 +46,9 @@ "Id": "3d1ebd63-cc2f-4596-b0f1-60bd22b96b46", "Cloud": "Prod", "Version": "beta", - "CreatedDateTime": "2024-10-25T07:34:17.3898972Z", - "WorkloadArea": "EnhancedRestore", - "SubArea": "Backup and Restore" + "CreatedDateTime": "2024-12-04T07:34:17.3898972Z", + "WorkloadArea": "Backup storage", + "SubArea": "" }, { "ChangeList": [ From 6530fee4a1057f39a3fd1f96e8f751bc25c87eb4 Mon Sep 17 00:00:00 2001 From: Laura Graham Date: Wed, 4 Dec 2024 19:39:02 -0800 Subject: [PATCH 143/144] Update Microsoft.Teams.Shifts.json --- changelog/Microsoft.Teams.Shifts.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/changelog/Microsoft.Teams.Shifts.json b/changelog/Microsoft.Teams.Shifts.json index a852f00266f..e6e1014cf7c 100644 --- a/changelog/Microsoft.Teams.Shifts.json +++ b/changelog/Microsoft.Teams.Shifts.json @@ -730,7 +730,7 @@ "Id": "3292bcc6-e31c-4e8e-a090-63b6f13eec0c", "Cloud": "Prod", "Version": "v1.0", - "CreatedDateTime": "2024-11-21T22:51:07.7910122Z", + "CreatedDateTime": "2024-12-04T22:51:07.7910122Z", "WorkloadArea": "Teamwork and communications", "SubArea": "Shift management" } From c59bf5fb89d24cb67c8f32abfe46cc65b8c08fbf Mon Sep 17 00:00:00 2001 From: Laura Graham Date: Wed, 4 Dec 2024 19:41:05 -0800 Subject: [PATCH 144/144] Update whats-new-overview.md --- concepts/whats-new-overview.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/concepts/whats-new-overview.md b/concepts/whats-new-overview.md index d72ffbaf661..0ac69cf1cec 100644 --- a/concepts/whats-new-overview.md +++ b/concepts/whats-new-overview.md @@ -17,6 +17,13 @@ For details about previous updates to Microsoft Graph, see [Microsoft Graph what > [!IMPORTANT] > Features in _preview_ status are subject to change without notice, and might not be promoted to generally available (GA) status. Don't use preview features in production apps. +## December 2024: New and generally available + +### Teamwork and communications | Shift management + +- [Stage the deletion](/graph/api/changetrackedentity-stagefordeletion) of an [openShift](/graph/api/resources/openshift), [shift](/graph/api/resources/shift), or [timeOff](/graph/api/resources/timeoff) instance in a [schedule](/graph/api/resources/schedule) in draft mode. +- Use the **eligibilityFilteringEnabledEntities** property on [workforceIntegration](/graph/api/resources/workforceintegration) to get or set support for viewing eligibility-filtered results. + ## December 2024: New in preview only ### Reports | Identity and access reports @@ -27,11 +34,6 @@ The Microsoft 365 monitoring APIs provide telemetry data to monitor the health o Create and manage a [news link page](/graph/api/resources/newslinkpage?view=graph-rest-beta&preserve-view=true) in SharePoint. -### Teamwork and communications | Shift management - -- [Stage the deletion](/graph/api/changetrackedentity-stagefordeletion) of an [openShift](/graph/api/resources/openshift), [shift](/graph/api/resources/shift), or [timeOff](/graph/api/resources/timeoff) instance in a [schedule](/graph/api/resources/schedule) in draft mode. -- Use the **eligibilityFilteringEnabledEntities** property on [workforceIntegration](/graph/api/resources/workforceintegration) to get or set support for viewing eligibility-filtered results. - ## November 2024: New and generally available ### Applications | Policies