Merge branch 'main' into hut/healthMonitoringDocs

Author: FaithOmbongi

api-reference/beta/api/chatmessage-delta.md

@@ -99,6 +99,7 @@ In this example, the chat messages synchronize for the first time and the initia
 
 The request specifies the optional `$top` query parameter that returns two messages at a time.
 
+# [HTTP](#tab/http)
 <!-- {
   "blockType": "request",
   "name": "get_chatmessagedeltachats_1"
@@ -107,6 +108,12 @@ The request specifies the optional `$top` query parameter that returns two messa
 GET https://graph.microsoft.com/beta/users/5ed12dd6-24f8-4777-be3d-0d234e06cefa/chats/getAllMessages/delta?$top=2
 ```
 
+# [JavaScript](#tab/javascript)
+[!INCLUDE [sample-code](../includes/snippets/javascript/get-chatmessagedeltachats-1-javascript-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+---
+
 #### Initial request response
 
 The response includes two messages and an **@odata.nextLink** response header with a `skipToken`. The **@odata.nextLink** URL indicates that more messages in the chats are available to retrieve.
@@ -206,6 +213,7 @@ Content-type: application/json
 
 The second request specifies the **@odata.nextLink** URL returned from the previous response. Notice that it no longer has to specify the same `$top` parameter as in the initial request, as the `skipToken` in the **@odata.nextLink** URL encodes and includes those parameters.
 
+# [HTTP](#tab/http)
 <!-- {
   "blockType": "request",
   "name": "get_chatmessagedeltachats_2"
@@ -214,6 +222,12 @@ The second request specifies the **@odata.nextLink** URL returned from the previ
 GET https://graph.microsoft.com/beta/users/5ed12dd6-24f8-4777-be3d-0d234e06cefa/chats/getAllMessages/delta?&%24skiptoken=a-5fqdzHFr_L_cc7C0q1F-HCB8Z9SjwOsMN37XV5yfSnYgK4jVGVGEl25GFlxKWq0Wv6quL-5qcNg4nUnxzof6namZ_DM5no-hcL515cSrRGDoRLn38fZE1AXoDugSTOohOq3YRCYLqJbFGIoovMPTar32oLuoltHixme-Bf1lZtscv1wv5uu-MtkpYZIT0uDw-umQUK7mLNjMcyhNaifMIVTT-htmEOClLVwgcyWLR-sl9Qb73uTTtPXdFdMK6FDE4gpwvvKxvo2ChsW2c4eo77LDh6ZL_WQ8Luq00koQ6vHIrLBHPMUdOAxDxu-U7N7H4hsFn9aRDRdwRky7067A.V2a-J-86yXTd9SJMA4CHP6enI-Ab-bQzRgYujwsIwDo
 ```
 
+# [JavaScript](#tab/javascript)
+[!INCLUDE [sample-code](../includes/snippets/javascript/get-chatmessagedeltachats-2-javascript-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+---
+
 #### Second request response
 
 The second response returns the next two messages and an **@odata.nextLink** response header with a `skipToken` that indicates that more messages are available to retrieve.
@@ -313,6 +327,7 @@ Content-type: application/json
 
 The third request continues to use the latest **@odata.nextLink** returned from the last sync request.
 
+# [HTTP](#tab/http)
 <!-- {
   "blockType": "request",
   "name": "get_chatmessagedeltachats_3"
@@ -321,6 +336,12 @@ The third request continues to use the latest **@odata.nextLink** returned from
 GET  https://graph.microsoft.com/beta/users/5ed12dd6-24f8-4777-be3d-0d234e06cefa/chats/getAllMessages/delta?$skiptoken=8UusBixEHS9UUau6uGcryrA6FpnWwMJbuTYILM1PArHxnZzDVcsHQrijNzCyIVeEauMQsKUfMhNjLWFs1o4sBS_LofJ7xMftZUfec_pijuT6cAk5ugcWCca9RCjK7iVj.DKZ9w4bX9vCR7Sj9P0_qxjLAAPiEZgxlOxxmCLMzHJ4
 ```
 
+# [JavaScript](#tab/javascript)
+[!INCLUDE [sample-code](../includes/snippets/javascript/get-chatmessagedeltachats-3-javascript-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+---
+
 #### Third request response
 
 The third response returns the only remaining messages and an **@odata.deltaLink** response header with a `deltaToken` which indicates that all messages are returned. Save and use the **@odata.deltaLink** URL to query for any new messages added or changed from this point onwards.
@@ -387,6 +408,7 @@ Using the **@odata.deltaLink** from the last request in the last round, you can
 
 The following example shows a request.
 
+# [HTTP](#tab/http)
 <!-- {
   "blockType": "request",
   "name": "get_chatmessagedeltachats_4"
@@ -395,6 +417,12 @@ The following example shows a request.
 GET https://graph.microsoft.com/beta/users/5ed12dd6-24f8-4777-be3d-0d234e06cefa/chats/getAllMessages/delta?$deltatoken=aQdvS1VwGCSRxVmZJqykmDik_JIC44iCZpv-GLiA2VnFuE5yG-kCEBROb2iaPT_y_eMWVQtBO_ejzzyIxl00ji-tQ3HzAbW4liZAVG88lO3nG_6-MBFoHY1n8y21YUzjocG-Cn1tCNeeLPLTzIe5Dw.EP9gLiCoF2CE_e6l_m1bTk2aokD9KcgfgfcLGqd1r_4
 ```
 
+# [JavaScript](#tab/javascript)
+[!INCLUDE [sample-code](../includes/snippets/javascript/get-chatmessagedeltachats-4-javascript-snippets.md)]
+[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
+
+---
+
 #### Response
 
 The following example shows the response.

api-reference/beta/api/cloudpc-getprovisionedcloudpcs.md

@@ -35,6 +35,10 @@ Choose the permission or permissions marked as least privileged for this API. Us
 GET /deviceManagement/virtualEndpoint/cloudPCs/getProvisionedCloudPCs(groupId='{groupId}',servicePlanId='{servicePlanId}')
 ```
 
+## Optional query parameters
+
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response. You can use `$select` to get specific properties, including those properties that aren't returned by default.
+
 ## Request headers
 
 |Name|Description|
@@ -58,14 +62,18 @@ If successful, this method returns a `200 OK` response code and a collection of
 
 ## Examples
 
-### Request
+### Example 1: Get all provisioned Cloud PCs and their default properties
+
+The following example shows how to get all provisioned Cloud PCs and their default properties.
+
+#### Request
 
 The following example shows a request.
 
 # [HTTP](#tab/http)
 <!-- {
   "blockType": "request",
-  "name": "cloudpc.getProvisionedCloudPCs"
+  "name": "cloudpc.getProvisionedCloudPCs_1"
 }
 -->
 ``` http
@@ -106,14 +114,16 @@ GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/g
 
 ---
 
-### Response
+#### Response
 
-The following example shows the response.
+The following example shows the response. It includes only the default properties.
+
+> **Note:** The response object shown here might be shortened for readability. All the default properties are returned in an actual call.
 
 <!-- {
   "blockType": "response",
   "@odata.type": "Collection(microsoft.graph.cloudPC)",
-  "name": "cloudpc.getProvisionedCloudPCs",
+  "name": "cloudpc.getProvisionedCloudPCs_1",
   "truncated": true
 }
 -->
@@ -138,22 +148,16 @@ Content-Type: application/json
             "servicePlanName": "Cloud PC Enterprise 4vCPU/16GB/256GB",
             "servicePlanType": "enterprise",
             "status": "provisioned",
-            "powerState": "running",
             "userPrincipalName": "pmitchell@contoso.com",
             "lastModifiedDateTime": "2020-07-23T10:29:57Z",
             "statusDetails": null,
             "provisioningType": "dedicated",
             "allotmentDisplayName": null,
             "deviceRegionName": "eastus2",
-            "connectivityResult": "",
             "gracePeriodEndDateTime": null,
-            "lastLoginResult": "2020-07-23T10:29:57Z",
-            "lastRemoteActionResult": "Succeed",
             "onPremisesConnectionName": "Test-OPNC",
-            "osVersion": null,
             "partnerAgentInstallResults": null,
-            "provisioningPolicyName": "Test-Policy",
-            "userAccountType": null
+            "provisioningPolicyName": "Test-Policy"
         },
         {
             "@odata.type": "#microsoft.graph.cloudPC",
@@ -169,23 +173,79 @@ Content-Type: application/json
             "servicePlanName": "Cloud PC Enterprise 4vCPU/16GB/256GB",
             "servicePlanType": "enterprise",
             "status": "provisioned",
-            "powerState": "running",
             "userPrincipalName": "pmitchell@contoso.com",
             "lastModifiedDateTime": "2020-07-28T18:14:34Z",
             "statusDetails": null,
             "provisioningType": "dedicated",
             "allotmentDisplayName": null,
             "deviceRegionName": "eastus2",
-            "connectivityResult": "",
             "gracePeriodEndDateTime": null,
-            "lastLoginResult": "2020-07-23T10:29:57Z",
-            "lastRemoteActionResult": "Succeed",
             "onPremisesConnectionName": "Test-OPNC",
-            "osVersion": null,
             "partnerAgentInstallResults": null,
-            "provisioningPolicyName": "Test-Policy",
-            "userAccountType": null
+            "provisioningPolicyName": "Test-Policy"
         }
     ]
 }
 ```
+
+### Example 2: Get all provisioned Cloud PCs and specific properties
+
+The following example shows how to get all provisioned Cloud PCs and use `$select` to get specific properties, including those properties that aren't returned by default.
+
+#### Request
+
+The following example shows a request.
+
+<!-- {
+  "blockType": "request",
+  "name": "cloudpc.getProvisionedCloudPCs_2"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/getProvisionedCloudPCs(groupId='30d0e128-de93-41dc-89ec-33d84bb662a0',servicePlanId='9ecf691d-8b82-46cb-b254-cd061b2c02fb')?$select=id,displayName,powerState,connectivityResult,lastLoginResult,lastRemoteActionResult,osVersion,provisioningPolicyName,userAccountType
+```
+
+#### Response
+
+The following example shows the response.
+
+<!-- {
+  "blockType": "response",
+  "@odata.type": "Collection(microsoft.graph.cloudPC)",
+  "name": "cloudpc.getProvisionedCloudPCs_2",
+  "truncated": true
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+  "value": [
+    {
+      "@odata.type": "#microsoft.graph.cloudPC",
+      "id": "662009bc-7732-4f6f-8726-25883518b33e",
+      "displayName": "Demo-0",
+      "powerState": "running",
+      "connectivityResult": "",
+      "lastLoginResult": "2020-07-23T10:29:57Z",
+      "lastRemoteActionResult": "Succeed",
+      "osVersion": null,
+      "provisioningPolicyName": "Test-Policy",
+      "userAccountType": null
+    },
+    {
+      "@odata.type": "#microsoft.graph.cloudPC",
+      "id": "ac74ae8b-85f7-4272-88cc-5419267403ed",
+      "displayName": "Demo-1",
+      "powerState": "running",
+      "connectivityResult": "",
+      "lastLoginResult": "2020-07-23T10:29:57Z",
+      "lastRemoteActionResult": "Succeed",
+      "osVersion": null,
+      "provisioningPolicyName": "Test-Policy",
+      "userAccountType": null
+    }
+  ]
+}
+```

api-reference/beta/api/educationalactivity-delete.md

@@ -19,7 +19,7 @@ Delete an [educationalActivity](../resources/educationalactivity.md) object from
 
 ## 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 syntax:
 
@@ -29,12 +29,12 @@ Permissions for the following HTTP syntax:
 DELETE /me/profile/educationalActivities/{id} 
 ```
 
-<!-- { "blockType": "permissions", "name": "educationalactivity_delete", "requestUrls": ["DELETE /me/profile/educationalActivities/{id}"]} -->
-|Permission type|Least privileged permissions|Higher privileged permissions|
-|:---|:---|:---|
-|Delegated (work or school account)|User.ReadWrite|User.ReadWrite.All|
-|Delegated (personal Microsoft account)|User.ReadWrite|Not available.|
-|Application|Not supported.|Not supported.|
+<!-- { 
+  "blockType": "permissions", 
+  "name": "educationalactivity_delete", 
+  "requestUrls": ["DELETE /me/profile/educationalActivities/{id}"]
+ } -->
+[!INCLUDE [permissions-table](../includes/permissions/educationalactivity-delete-permissions.md)]
 
 Permissions for the following HTTP syntax:
 
@@ -44,12 +44,12 @@ Permissions for the following HTTP syntax:
 DELETE /users/{id | userPrincipalName}/profile/educationalActivities/{id}
 ```
 
-<!-- { "blockType": "permissions", "name": "educationalactivity_delete", "requestUrls": ["DELETE /users/{id | userPrincipalName}/profile/educationalActivities/{id}"]} -->
-|Permission type|Least privileged permissions|Higher privileged permissions|
-|:---|:---|:---|
-|Delegated (work or school account)|User.ReadWrite|User.ReadWrite.All|
-|Delegated (personal Microsoft account)|User.ReadWrite|Not available.|
-|Application|User.ReadWrite.All|Not available.|
+<!-- { 
+  "blockType": "permissions", 
+  "name": "educationalactivity_delete_2", 
+  "requestUrls": ["DELETE /users/{id | userPrincipalName}/profile/educationalActivities/{id}"]
+ } -->
+[!INCLUDE [permissions-table](../includes/permissions/educationalactivity-delete-2-permissions.md)]
 
 ## HTTP request
 

api-reference/beta/api/educationalactivity-get.md

@@ -19,7 +19,7 @@ Retrieve the properties and relationships of an [educationalActivity](../resourc
 
 ## 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 syntax:
 
@@ -29,12 +29,12 @@ Permissions for the following HTTP syntax:
 GET /me/profile/educationalActivities/{id}
 ```
 
-<!-- { "blockType": "permissions", "name": "educationalactivity_get", "requestUrls": ["GET /me/profile/educationalActivities/{id}"]} -->
-|Permission type|Least privileged permissions|Higher privileged permissions|
-|:---|:---|:---|
-|Delegated (work or school account)|User.Read|User.ReadWrite, User.Read.All, User.ReadBasic.All, User.ReadWrite.All|
-|Delegated (personal Microsoft account)|User.Read|User.ReadWrite|
-|Application|Not supported.|Not supported.|
+<!-- { 
+  "blockType": "permissions", 
+  "name": "educationalactivity_get", 
+  "requestUrls": ["GET /me/profile/educationalActivities/{id}"]
+ } -->
+[!INCLUDE [permissions-table](../includes/permissions/educationalactivity-get-permissions.md)]
 
 Permissions for the following HTTP syntax:
 
@@ -44,12 +44,12 @@ Permissions for the following HTTP syntax:
 GET /users/{id | userPrincipalName}/profile/educationalActivities/{id}
 ```
 
-<!-- { "blockType": "permissions", "name": "educationalactivity_get", "requestUrls": ["GET /users/{id | userPrincipalName}/profile/educationalActivities/{id}"]} -->
-|Permission type|Least privileged permissions|Higher privileged permissions|
-|:---|:---|:---|
-|Delegated (work or school account)|User.Read|User.ReadWrite, User.Read.All, User.ReadBasic.All, User.ReadWrite.All|
-|Delegated (personal Microsoft account)|User.Read|User.ReadWrite|
-|Application|User.Read.All|User.ReadWrite.All|
+<!-- { 
+  "blockType": "permissions", 
+  "name": "educationalactivity_get_2", 
+  "requestUrls": ["GET /users/{id | userPrincipalName}/profile/educationalActivities/{id}"]
+ } -->
+[!INCLUDE [permissions-table](../includes/permissions/educationalactivity-get-2-permissions.md)]
 
 ## HTTP request
 

api-reference/beta/api/educationalactivity-update.md

@@ -19,7 +19,7 @@ Update the properties of an [educationalActivity](../resources/educationalactivi
 
 ## 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 syntax:
 
@@ -29,12 +29,12 @@ Permissions for the following HTTP syntax:
 PATCH /me/profile/educationalActivities/{id}
 ```
 
-<!-- { "blockType": "permissions", "name": "educationalactivity_update", "requestUrls": ["PATCH /me/profile/educationalActivities/{id}"]} -->
-|Permission type|Least privileged permissions|Higher privileged permissions|
-|:---|:---|:---|
-|Delegated (work or school account)|User.ReadWrite|User.ReadWrite.All|
-|Delegated (personal Microsoft account)|User.ReadWrite|Not avaialable.|
-|Application|Not supported.|Not supported.|
+<!-- { 
+  "blockType": "permissions", 
+  "name": "educationalactivity_update", 
+  "requestUrls": ["PATCH /me/profile/educationalActivities/{id}"]
+ } -->
+[!INCLUDE [permissions-table](../includes/permissions/educationalactivity-update-permissions.md)]
 
 Permissions for the following HTTP syntax:
 
@@ -44,12 +44,12 @@ Permissions for the following HTTP syntax:
 PATCH /users/{id | userPrincipalName}/profile/educationalActivities/{id}
 ```
 
-<!-- { "blockType": "permissions", "name": "educationalactivity_update", "requestUrls": ["PATCH /users/{id | userPrincipalName}/profile/educationalActivities/{id}"]} -->
-|Permission type|Least privileged permissions|Higher privileged permissions|
-|:---|:---|:---|
-|Delegated (work or school account)|User.ReadWrite|User.ReadWrite.All|
-|Delegated (personal Microsoft account)|User.ReadWrite|Not avaialable.|
-|Application|User.ReadWrite.All|Not available.|
+<!-- { 
+  "blockType": "permissions", 
+  "name": "educationalactivity_update_2", 
+  "requestUrls": ["PATCH /users/{id | userPrincipalName}/profile/educationalActivities/{id}"]
+ } -->
+[!INCLUDE [permissions-table](../includes/permissions/educationalactivity-update-2-permissions.md)]
 
 ## HTTP request
 

api-reference/beta/api/filestoragecontainer-list-columns.md

@@ -97,7 +97,6 @@ GET https://graph.microsoft.com/beta/storage/fileStorage/containers/b!ISJs1WRro0
 
 ---
 
-
 ### Response
 
 The following example shows the response.