Merge pull request #25839 from microsoftgraph/main

Merge to publish.
microsoftgraph · Dec 5, 2024 · c82260d · c82260d
2 parents 02f4368 + bb84a59
commit c82260d
Show file tree

Hide file tree

Showing 89 changed files with 1,169 additions and 994 deletions.
diff --git 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).
 
-<!-- { "blockType": "permissions", "name": "aiinteractionhistory-getallenterpriseinteractions" } -->
+<!-- { "blockType": "permissions", "name": "aiinteractionhistory_getallenterpriseinteractions" } -->
 [!INCLUDE [permissions-table](../includes/permissions/aiinteractionhistory-getallenterpriseinteractions-permissions.md)]
 
 ## HTTP request

diff --git 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 tenant in which this application is registered. Required.|
+|appOwnerTenantId|String|The ID of the owning tenant. The owning tenant contains the billing profile.|
 
 ## Response
 
@@ -135,4 +135,3 @@ HTTP/1.1 200 OK
     "lastModifiedDateTime":"2023-06-19T12:01:03.45Z"
 }
 ```
-
diff --git 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",

diff --git 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",

diff --git a/...reference/beta/api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md b/...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
@@ -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",

diff --git 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",

diff --git a/api-reference/beta/api/changetrackedentity-stagefordeletion.md b/api-reference/beta/api/changetrackedentity-stagefordeletion.md
@@ -20,7 +20,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).
 
 <!-- {
   "blockType": "permissions",

diff --git 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
@@ -23,8 +24,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
 

diff --git 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",

diff --git 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).
 
-<!-- {
-  "blockType": "permissions",
-  "name": "newslinkpage-list-permissions"
-}
--->
+<!-- { "blockType": "permissions", "name": "newslinkpage_list" } -->
 [!INCLUDE [permissions-table](../includes/permissions/newslinkpage-list-permissions.md)]
 
 ## HTTP request

diff --git a/api-reference/beta/api/openshift-post.md b/api-reference/beta/api/openshift-post.md
@@ -1,10 +1,11 @@
 ---
 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"
 doc_type: "apiPageType"
+ms.date: 11/30/2024
 ---
 
 # Create openShift
@@ -13,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)]
 
@@ -56,7 +57,8 @@ The following example shows a request.
 # [HTTP](#tab/http)
 <!-- {
   "blockType": "request",
-  "name": "openshift_post"
+  "name": "openshift_post",
+  "sampleKeys": ["788b75d2-a911-48c0-a5e2-dc98480457e3"]
 }-->
 
 ```http

diff --git 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",

diff --git 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",

diff --git 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).
 
- <!-- { "blockType": "permissions", "name": "sitepage_createFromTemplate" } -->
+<!-- { "blockType": "permissions", "name": "sitepage_createfromtemplate" } -->
 [!INCLUDE [permissions-table](../includes/permissions/sitepage-createfromtemplate-permissions.md)]
 
 ## HTTP request

diff --git a/...ence/beta/includes/permissions/application-post-onlinemeetings-2-permissions.md b/...ence/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.|
+|Application|OnlineMeetings.ReadWrite.All|Not available.|
+
diff --git a/...erence/beta/includes/permissions/application-post-onlinemeetings-permissions.md b/...erence/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.|
+|Application|Not supported.|Not supported.|
+
diff --git a/...nce/beta/includes/permissions/fido2authenticationmethod-delete-2-permissions.md b/...nce/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/...rence/beta/includes/permissions/fido2authenticationmethod-delete-permissions.md b/...rence/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
@@ -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.|
+|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
@@ -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|
+|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
@@ -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.|
+|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
@@ -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.|
+|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
@@ -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|
+|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
@@ -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.|
+|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
@@ -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.|
+|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
@@ -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|
+|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
@@ -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.|
+|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
@@ -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.|
+|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
@@ -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.|
+|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
@@ -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|