Merge branch 'add-import-notes-to-create-client' of https://github.com/microsoftgraph/microsoft-graph-docs into add-import-notes-to-create-client

Author: mnorman-ms

.azure-pipelines/.config/CredScanSuppressions.json

@@ -56,6 +56,10 @@
     {
       "hash": "ncUPsLmVZWNkFs8Upvo2loZCG/3RAMIinoJ0OennEZ0=",
       "_justification": "tutorial-accessreviews-roleassignments.md line 773 Sample Azure Storage Account Shared Access Signature"
+    },
+    {
+      "hash": "LIUwvKZoGemir5C2hxlAlMXrAJIYqol3WOojWbNRRWY=",
+      "_justification": "update-socialidentityprovider-python-snippets.md line 13 Sample general password in snippet example"
     }
   ]
 }

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
@@ -34,16 +34,6 @@ GET /copilot/users/{id}/interactionHistory/getAllEnterpriseInteractions
 
 ## Optional query parameters
 
-You can use the `model` query parameter, which supports the values `A` and `B`, based on the preferred [licensing and payment model](/graph/teams-licenses), as shown in the following examples.
-
-<!-- { "blockType": "ignored" } -->
-```http
-GET /copilot/users/{id}/interactionHistory/getAllEnterpriseInteractions?model=A
-GET /copilot/users/{id}/interactionHistory/getAllEnterpriseInteractions?model=B
-```
-
-If no `model` parameter is specified, [evaluation mode](/graph/teams-licenses#evaluation-mode-default-requirements) is used.
-
 This method supports [date range parameters](/graph/query-parameters) to customize the response, as shown in the following example.
 
 <!-- { "blockType": "ignored" } -->

api-reference/beta/api/application-post-onlinemeetings.md

@@ -24,7 +24,7 @@ Create an online meeting on behalf of a user.
 [!INCLUDE [national-cloud-support](../../includes/global-only.md)]
 
 ## 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).
+The following tables show the least privileged permission or permissions required to call this API on each supported resource type. Follow [best practices](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions) to request least privileged 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).
 
 Permissions for the following HTTP request:
 
@@ -39,12 +39,7 @@ POST /me/onlineMeetings
   "name": "application_post_onlinemeetings", 
   "requestUrls": ["POST /me/onlineMeetings"]
  } -->
-
-|Permission type|Least privileged permissions|Higher privileged permissions|
-|:---|:---|:---|
-|Delegated (work or school account)|OnlineMeetings.ReadWrite|Not available.|
-|Delegated (personal Microsoft account)|Not supported.|Not supported.|
-|Application|Not supported.|Not supported.|
+[!INCLUDE [permissions-table](../includes/permissions/application-post-onlinemeetings-permissions.md)]
 
 
 Permissions for the following HTTP request:
@@ -60,12 +55,7 @@ POST /users/{userId}/onlineMeetings
   "name": "application_post_onlinemeetings_2", 
   "requestUrls": ["POST /users/{userId}/onlineMeetings"]
  } -->
-
-|Permission type|Least privileged permissions|Higher privileged permissions|
-|:---|:---|:---|
-|Delegated (work or school account)|OnlineMeetings.ReadWrite|Not available.|
-|Delegated (personal Microsoft account)|Not supported.|Not supported.|
-|Application|OnlineMeetings.ReadWrite.All|Not available.|
+[!INCLUDE [permissions-table](../includes/permissions/application-post-onlinemeetings-2-permissions.md)]
 
 > [!NOTE]
 > To use the OnlineMeetings.ReadWrite.All application permission for this API, tenant administrators must create an [application access policy](/graph/cloud-communication-online-meeting-application-access-policy) and grant it to a user to authorize the app configured in the policy to create online meetings on behalf of that user (with user ID specified in the request path).

api-reference/beta/api/attacksimulationroot-post-simulation.md

@@ -77,6 +77,7 @@ If successful, this method returns a `202 Accepted` response code and a tracking
 
 The following example shows a request.
 
+# [HTTP](#tab/http)
 <!-- {
   "blockType": "request",
   "name": "create_simulations"
@@ -125,6 +126,40 @@ Content-type: application/json
 }
 ```
 
+# [C#](#tab/csharp)
+[!INCLUDE [sample-code](../includes/snippets/csharp/create-simulations-csharp-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [CLI](#tab/cli)
+[!INCLUDE [sample-code](../includes/snippets/cli/create-simulations-cli-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [Go](#tab/go)
+[!INCLUDE [sample-code](../includes/snippets/go/create-simulations-go-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [Java](#tab/java)
+[!INCLUDE [sample-code](../includes/snippets/java/create-simulations-java-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [JavaScript](#tab/javascript)
+[!INCLUDE [sample-code](../includes/snippets/javascript/create-simulations-javascript-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [PHP](#tab/php)
+[!INCLUDE [sample-code](../includes/snippets/php/create-simulations-php-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [PowerShell](#tab/powershell)
+[!INCLUDE [sample-code](../includes/snippets/powershell/create-simulations-powershell-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+# [Python](#tab/python)
+[!INCLUDE [sample-code](../includes/snippets/python/create-simulations-python-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+---
+
 ### Response
 
 The following example shows the response.

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"
 }
 ```
-

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

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

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
@@ -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",

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

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