Merge pull request #22671 from microsoftgraph/main

Daily publishing from last week

api-reference/beta/api/alert-list.md

@@ -56,7 +56,7 @@ The following table lists the `$filter` keywords by each vendor name. Even thoug
 | Azure Security Center | ASC |
 | Microsoft Defender for Cloud Apps | MCAS |
 | Azure Active Directory Identity Protection | IPC |
-| Azure Sentinel | Azure Sentinel |
+| Microsoft Sentinel | Azure Sentinel |
 | Microsoft Defender for Endpoint | Microsoft Defender ATP |
 | Office 365 |  Not currently supported. |
 

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

@@ -12,7 +12,7 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Update the properties of an [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) object. In use, only [fido2combinationConfigurations](../resources/fido2combinationconfiguration.md) may be updated as they are the only type of [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) that may be created.
+Update the properties of an [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) object. In use, only [fido2combinationConfigurations](../resources/fido2combinationconfiguration.md) may be updated as they're the only type of [authenticationCombinationConfiguration](../resources/authenticationcombinationconfiguration.md) that may be created.
 
 ## 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).
@@ -47,7 +47,7 @@ PATCH /identity/conditionalAccess/authenticationStrength/policies/{authenticatio
 
 |Property|Type|Description|
 |:---|:---|:---|
-|appliesToCombinations|authenticationMethodModes collection|The combinations to which this configuration applies. The only possible value for fido2combinationConfigurations is `fido2`. Required.|
+|appliesToCombinations|authenticationMethodModes collection|Specifies the combinations to which this configuration applies. The only possible value for fido2combinationConfigurations is `fido2`. Required.|
 
 
 
@@ -58,7 +58,7 @@ If successful, this method returns a `204 NO CONTENT` response code.
 ## Examples
 
 ### Request
-The following is an example of a request.
+Here's an example of a request.
 
 # [HTTP](#tab/http)
 <!-- {
@@ -107,7 +107,7 @@ Content-length: 130
 ---
 
 ### Response
-The following is an example of the response
+Here's an example of the response
 <!-- {
   "blockType": "response",
   "truncated": true,

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

@@ -52,7 +52,7 @@ You must include the **@odata.type** property with a value of the specific user
 |id|String|The unique identifier for the entity. Read-only. |
 |displayName|String|The display name for the events policy. |
 |description|String|The description of the events policy.|
-|conditions|[authenticationConditions](../resources/authenticationconditions.md)|The conditions representing the context of the authentication request which is used to decide whether the events policy is invoked. |
+|conditions|[authenticationConditions](../resources/authenticationconditions.md)|The conditions representing the context of the authentication request that is used to decide whether the events policy is invoked. |
 |priority|Int32|The priority to use for each individual event of the events policy. If multiple competing listeners for an event have the same priority, one is chosen and an error is silently logged. |
 |onInteractiveAuthFlowStart|[onInteractiveAuthFlowStartHandler](../resources/oninteractiveauthflowstarthandler.md)|The configuration for what to invoke for the onInteractiveAuthFlowStart event. |
 |onAuthenticationMethodLoadStart|[onAuthenticationMethodLoadStartHandler](../resources/onauthenticationmethodloadstarthandler.md)|The configuration for what to invoke for the onAuthenticationMethodLoadStart event. Must have at least one identity provider linked.|
@@ -61,14 +61,14 @@ You must include the **@odata.type** property with a value of the specific user
 
 ## Response
 
-If successful, this method returns a `204 No Content` response code. If unsuccessful, a `4xx` error will be returned with specific details.
+If successful, this method returns a `204 No Content` response code. If unsuccessful, a `4xx` error is returned with specific details.
 
 ## Examples
 
 ### Example 1: Update the display name and priority of an authenticationEventsFlow
 
 #### Request
-The following is an example of a request that updates the display name of a specific external identities user flow ( an authentication event type), as well as the priority for all the listeners associated with the policy.
+Here's an example of a request that updates the display name of a specific external identities user flow (an authentication event type), as well as the priority for all the listeners associated with the policy.
 
 # [HTTP](#tab/http)
 <!-- {
@@ -122,7 +122,7 @@ Content-Type: application/json
 ---
 
 #### Response
-The following is an example of the response
+Here's an example of the response
 <!-- {
   "blockType": "response",
   "truncated": true
@@ -251,7 +251,7 @@ Content-Type: application/json
 
 #### Response
 
-The following is an example of the response
+Here's an example of the response
 <!-- {
   "blockType": "response",
   "truncated": true
@@ -263,7 +263,7 @@ HTTP/1.1 204 No Content
 
 ### Example 3: Remove an attribute collected during a self-service sign up user flow
 
-Remove city as an attribute to be collected during the attribute collection step of a self-service sign up user flow. By excluding the city attribute from the request body, the attribute will be removed from the user flow.
+Remove city as an attribute to be collected during the attribute collection step of a self-service sign up user flow. By excluding the city attribute from the request body, the attribute is removed from the user flow.
 
 #### Request
 
@@ -368,7 +368,7 @@ Content-Type: application/json
 
 #### Response
 
-The following is an example of the response
+Here's an example of the response
 <!-- {
   "blockType": "response",
   "truncated": true

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

@@ -48,19 +48,19 @@ This method supports the `$expand` OData query parameter to expand the details o
 
 ## Request body
 
-Do not supply a request body for this method.
+Don't supply a request body for this method.
 
 ## Response
 
 If successful, this method returns a `200 OK` response code and an [authenticationListener](../resources/authenticationlistener.md) object in the response body.
 
 ## Examples
 
-### Example 1: Get an authenticationListener by id
+### Example 1: Get an authenticationListener by ID
 
 #### Request
 
-The following is an example of the request.
+Here's an example of the request.
 
 <!-- {
   "blockType": "request",
@@ -74,7 +74,7 @@ GET https://graph.microsoft.com/beta/identity/events/onSignupStart/{id}
 
 #### Response
 
-The following is an example of the response.
+Here's an example of the response.
 
 **Note:** The response object shown here might be shortened for readability.
 <!-- {
@@ -103,11 +103,11 @@ Content-Type: application/json
 
 ### Example 2: Expand invokeUserFlowListener for a specific authenticationListener
 
-The following example gets the listener by id for the onSignupStart event and expands the user flow that is invoked.
+The following example gets the listener by ID for the onSignupStart event and expands the user flow that is invoked.
 
 #### Request
 
-The following is an example of the request.
+Here's an example of the request.
 
 <!-- {
   "blockType": "request",
@@ -121,7 +121,7 @@ GET https://graph.microsoft.com/beta/identity/events/onSignupStart/{id}?$expand=
 
 #### Response
 
-The following is an example of the response.
+Here's an example of the response.
 
 **Note:** The response object shown here might be shortened for readability.
 <!-- {

api-reference/beta/api/b2cidentityuserflow-put-apiconnectorconfiguration.md

@@ -62,7 +62,7 @@ If successful, this method returns a `204 No Content` response code.
 
 #### Request
 
-The following is an example of the request.
+Here's an example of the request.
 
 
 # [HTTP](#tab/http)
@@ -94,7 +94,7 @@ Content-Type: application/json
 
 #### Response 
 
-The following is an example of the response.
+Here's an example of the response.
 
 <!-- {
   "blockType": "response",
@@ -109,7 +109,7 @@ HTTP/1.1 204 No Content
 
 #### Request 
 
-The following is an example of the request.
+Here's an example of the request.
 
 
 # [HTTP](#tab/http)
@@ -141,7 +141,7 @@ Content-Type: application/json
 
 #### Response
 
-The following is an example of the response.
+Here's an example of the response.
 
 <!-- {
   "blockType": "response",
@@ -156,7 +156,7 @@ HTTP/1.1 204 No Content
 
 #### Request 
 
-The following is an example of the request.
+Here's an example of the request.
 
 
 
@@ -187,7 +187,7 @@ Content-Type: application/json
 
 #### Response
 
-The following is an example of the response.
+Here's an example of the response.
 
 <!-- {
   "blockType": "response",

api-reference/beta/api/b2xidentityuserflow-list-userflowidentityproviders.md

@@ -46,7 +46,7 @@ GET /identity/b2xUserFlows/{userflow-id}/userflowIdentityProviders
 
 ## Request body
 
-Do not supply a request body for this method.
+Don't supply a request body for this method.
 
 ## Response
 
@@ -56,7 +56,7 @@ If successful, this method returns a `200 OK` response code and a collection of
 
 ### Request
 
-The following is an example of the request.
+Here's an example of the request.
 
 
 # [HTTP](#tab/http)
@@ -103,7 +103,7 @@ GET https://graph.microsoft.com/beta/identity/b2xUserFlows/B2X_1_Test/userflowId
 
 ### Response
 
-The following is an example of the response.
+Here's an example of the response.
 
 **Note:** The response object shown here might be shortened for readability.
 

api-reference/beta/api/b2xidentityuserflow-post-identityproviders.md

@@ -52,13 +52,13 @@ In the request body, provide a JSON representation of the `id` of the [identityP
 
 ## Response
 
-If successful, this method returns a `204 No Content` response code. If unsuccessful, a `4xx` error will be returned with specific details.
+If successful, this method returns a `204 No Content` response code. If unsuccessful, a `4xx` error is returned with specific details.
 
 ## Example
 
 ### Request
 
-The following is an example of the request.
+Here's an example of the request.
 
 
 # [HTTP](#tab/http)
@@ -89,7 +89,7 @@ Content-type: application/json
 
 ### Response
 
-The following is an example of the response.
+Here's an example of the response.
 
 <!-- {
   "blockType": "response",

api-reference/beta/api/b2xidentityuserflow-put-apiconnectorconfiguration.md

@@ -62,7 +62,7 @@ If successful, this method returns a `204 No Content` response code.
 
 #### Request
 
-The following is an example of the request.
+Here's an example of the request.
 
 # [HTTP](#tab/http)
 <!-- {
@@ -117,7 +117,7 @@ Content-Type: application/json
 
 #### Response 
 
-The following is an example of the response.
+Here's an example of the response.
 
 <!-- {
   "blockType": "response",
@@ -132,7 +132,7 @@ HTTP/1.1 204 No Content
 
 #### Request 
 
-The following is an example of the request.
+Here's an example of the request.
 
 
 # [HTTP](#tab/http)
@@ -188,7 +188,7 @@ Content-Type: application/json
 
 #### Response
 
-The following is an example of the response.
+Here's an example of the response.
 
 <!-- {
   "blockType": "response",
@@ -203,7 +203,7 @@ HTTP/1.1 204 No Content
 
 #### Request 
 
-The following is an example of the request.
+Here's an example of the request.
 
 
 # [HTTP](#tab/http)
@@ -257,7 +257,7 @@ Content-Type: application/json
 
 #### Response
 
-The following is an example of the response.
+Here's an example of the response.
 
 <!-- {
   "blockType": "response",

api-reference/beta/api/call-redirect.md

@@ -49,18 +49,18 @@ In the request body, provide a JSON object with the following parameters.
 
 | Parameter      | Type    |Description|
 |:---------------|:--------|:----------|
-|targets|[invitationParticipantInfo](../resources/invitationparticipantinfo.md) collection|The target participants of the redirect operation. If more than one target is specified, it's a simulring call. This means that all of the targets will be rang at the same time and only the first target that picks up will be connected. We support up to 25 targets for simulring.
-|targetDisposition|String|(Deprecated) The possible values are: `default` , `simultaneousRing` , `forward`. This parameter is deprecated, we will automatically identify whether it's a forward call or simulring call from the number of targets provided.|
+|targets|[invitationParticipantInfo](../resources/invitationparticipantinfo.md) collection|The target participants of the redirect operation. If more than one target is specified, it's a simulring call. This means that all of the targets are called at the same time and only the first target that picks up will be connected. We support up to 25 targets for simulring.
+|targetDisposition|String|(Deprecated) The possible values are: `default` , `simultaneousRing` , `forward`. This parameter is deprecated, we'll automatically identify whether it's a forward call or simulring call from the number of targets provided.|
 |timeout|Int32|The timeout (in seconds) for the redirect operation. The range of the timeout value is between 15 and 90 seconds inclusive. The default timeout value is 55 seconds for one target and 60 seconds for multiple targets (subject to change). |
 |maskCallee|Boolean|Indicates whether the callee is to be hidden from the caller. If true, then the callee identity is the bot identity. Default: false.|
 |maskCaller|Boolean|Indicates whether the caller is to be hidden from the callee. If true, then the caller identity is the bot identity. Default: false.|
-|callbackUri|String|This allows bots to provide a specific callback URI for the current call to receive later notifications. If this property has not been set, the bot's global callback URI will be used instead. This must be `https`.|
+|callbackUri|String|This allows bots to provide a specific callback URI for the current call to receive later notifications. If this property hasn't been set, the bot's global callback URI is used instead. This must be `https`.|
 
 ## Response
 If successful, this method returns a `202 Accepted` response code.
 
 ## Examples
-These examples will cover a workflow of an incoming call notification and how that call will be redirected.
+These examples cover a workflow of an incoming call notification and how that call will be redirected.
 
 > **Note:** The response objects shown here might be shortened for readability. All the properties will be returned from an actual call.
 

api-reference/beta/api/chartseries-post-points.md

@@ -34,7 +34,7 @@ POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/se
 | Name       | Description|
 |:---------------|:----------|
 | Authorization  | Bearer {token}. Required. |
-| Workbook-Session-Id  | Workbook session Id that determines if changes are persisted or not. Optional.|
+| Workbook-Session-Id  | Workbook session ID that determines if changes are persisted or not. Optional.|
 
 ## Request body
 In the request body, supply a JSON representation of [workbookChartPoint](../resources/workbookchartpoint.md) object.
@@ -45,7 +45,7 @@ If successful, this method returns `201 Created` response code and [workbookChar
 
 ## Example
 ##### Request
-Here is an example of the request.
+Here's an example of the request.
 
 # [HTTP](#tab/http)
 <!-- {
@@ -92,7 +92,7 @@ Content-type: application/json
 
 In the request body, supply a JSON representation of [workbookChartPoint](../resources/workbookchartpoint.md) object.
 ##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+Here's an example of the response. Note: The response object shown here might be shortened for readability.
 <!-- {
   "blockType": "response",
   "truncated": true,

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

@@ -51,7 +51,7 @@ GET /deviceManagement/virtualEndpoint/cloudPCs/getProvisionedCloudPCs(groupId='{
 
 ## Request body
 
-Do not supply a request body for this method.
+Don't supply a request body for this method.
 
 ## Response
 
@@ -61,7 +61,7 @@ If successful, this method returns a `200 OK` response code and a [cloudPC](../r
 
 ### Request
 
-The following is an example of a request.
+Here's an example of a request.
 
 # [HTTP](#tab/http)
 <!-- {
@@ -105,7 +105,7 @@ GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/g
 
 ### Response
 
-The following is an example of the response.
+Here's an example of the response.
 
 <!-- {
   "blockType": "response",