Skip to content

Commit 27e5c19

Browse files
Learn Build Service GitHub AppLearn Build Service GitHub App
Learn Build Service GitHub App
authored and
Learn Build Service GitHub App
committed
Merging changes synced from https://github.com/microsoftgraph/microsoft-graph-docs (branch live)
2 parents 65668a8 + 0af66a5 commit 27e5c19

24 files changed

+336
-11
lines changed

‎api-reference/beta/api/authentication-delete-qrcodepinmethod.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
1616

1717
Deletes user's [qrCodePinAuthenticationMethod](../resources/qrcodepinauthenticationmethod.md) object. Once the object is deleted, it can't be retrieved. The user won't be able to sign-in with any QR codes associated with the deleted object.
1818

19+
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
20+
1921
## Permissions
2022
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).
2123

‎api-reference/beta/api/enhancedpersonalizationsetting-get.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
1616

1717
Read the properties and relationships of an [enhancedPersonalizationSetting](../resources/enhancedpersonalizationsetting.md) object.
1818

19+
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
20+
1921
## Permissions
2022

2123
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).

‎api-reference/beta/api/enhancedpersonalizationsetting-update.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
1616

1717
Update the properties of an [enhancedPersonalizationSetting](../resources/enhancedpersonalizationsetting.md) object.
1818

19+
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
20+
1921
## Permissions
2022

2123
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).

‎api-reference/beta/api/qrcode-delete.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
1616

1717
Delete a standard or temporary [qrCode](../resources/qrcode.md) object.
1818

19+
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
20+
1921
## Permissions
2022
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).
2123

‎api-reference/beta/api/qrcode-get.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
1616

1717
Read the properties and relationships of a [qrCode](../resources/qrcode.md) object.
1818

19+
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
20+
1921
## Permissions
2022

2123
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).

‎api-reference/beta/api/qrcode-update.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
1616

1717
Create a standard or temporary QR code, if there is no active QR code, or update a standard QR code. Only the **expireDateTime** property can be updated for a standard QR code.
1818

19+
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
20+
1921
## Permissions
2022

2123
### Permissions acting on self

‎api-reference/beta/api/qrcodepinauthenticationmethod-get.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
1616

1717
Retrieve a user's [qrCodePinAuthenticationMethod](../resources/qrcodepinauthenticationmethod.md) object.
1818

19+
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
20+
1921
## Permissions
2022
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).
2123

‎api-reference/beta/api/qrpin-update.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Namespace: microsoft.graph
1616

1717
Reset a user's PIN and generate a new temporary PIN that's represented by a [qrPin](../resources/qrpin.md) object and is linked to the user's [QR Code authentication method](../resources/qrcodepinauthenticationmethod.md) object.
1818

19+
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
20+
1921
## Permissions
2022
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).
2123

‎api-reference/beta/api/recommendationconfiguration-get.md

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
---
2+
title: "Get recommendationConfiguration"
3+
description: "Read the properties and relationships of a recommendationConfiguration object."
4+
author: "mbrndiar"
5+
ms.date: 04/23/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-monitoring-health"
8+
doc_type: apiPageType
9+
---
10+
11+
# Get recommendationConfiguration
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Read the properties and relationships of a recommendationConfiguration object.
18+
19+
## Permissions
20+
21+
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).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "recommendationconfiguration-get-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/recommendationconfiguration-get-permissions.md)]
29+
30+
[!INCLUDE [rbac-directory-recommendations-apis-read](../includes/rbac-for-apis/rbac-directory-recommendations-apis-read.md)]
31+
32+
## HTTP request
33+
34+
<!-- {
35+
"blockType": "ignored"
36+
}
37+
-->
38+
``` http
39+
GET /directory/recommendationConfiguration
40+
```
41+
42+
## Request headers
43+
44+
|Name|Description|
45+
|:---|:---|
46+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
47+
48+
## Request body
49+
50+
Don't supply a request body for this method.
51+
52+
## Response
53+
54+
If successful, this method returns a `200 OK` response code and a [recommendationConfiguration](../resources/recommendationconfiguration.md) object in the response body.
55+
56+
## Examples
57+
58+
### Request
59+
60+
The following example shows a request.
61+
<!-- {
62+
"blockType": "request",
63+
"name": "get_recommendationconfiguration"
64+
}
65+
-->
66+
``` http
67+
GET https://graph.microsoft.com/beta/directory/recommendationConfiguration
68+
```
69+
70+
### Response
71+
72+
The following example shows the response.
73+
>**Note:** The response object shown here might be shortened for readability.
74+
<!-- {
75+
"blockType": "response",
76+
"truncated": true,
77+
"@odata.type": "microsoft.graph.recommendationConfiguration"
78+
}
79+
-->
80+
``` http
81+
HTTP/1.1 200 OK
82+
Content-Type: application/json
83+
84+
{
85+
"value": {
86+
"@odata.type": "#microsoft.graph.recommendationConfiguration",
87+
"isNotificationEnabled": true
88+
}
89+
}
90+
```

‎api-reference/beta/api/recommendationconfiguration-update.md

Lines changed: 92 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,92 @@
1+
---
2+
title: "Update recommendationConfiguration"
3+
description: "Update the properties of a recommendationConfiguration object."
4+
author: "mbrndiar"
5+
ms.date: 04/23/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-monitoring-health"
8+
doc_type: apiPageType
9+
---
10+
11+
# Update recommendationConfiguration
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Update the properties of a recommendationConfiguration object.
18+
19+
## Permissions
20+
21+
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).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "recommendationconfiguration-update-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/recommendationconfiguration-update-permissions.md)]
29+
30+
[!INCLUDE [rbac-directory-recommendations-apis-write](../includes/rbac-for-apis/rbac-directory-recommendations-configuration-apis-write.md)]
31+
32+
## HTTP request
33+
34+
<!-- {
35+
"blockType": "ignored"
36+
}
37+
-->
38+
``` http
39+
PATCH /directory/recommendationConfiguration
40+
```
41+
42+
## Request headers
43+
44+
|Name|Description|
45+
|:---|:---|
46+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
47+
|Content-Type|application/json. Required.|
48+
49+
## Request body
50+
51+
[!INCLUDE [table-intro](../../includes/update-property-table-intro.md)]
52+
53+
|Property|Type|Description|
54+
|:---|:---|:---|
55+
|isNotificationEnabled|Boolean|Indicates whether notifications for recommendations are enabled. Required.|
56+
57+
## Response
58+
59+
If successful, this method returns a `204 OK` response code
60+
61+
## Examples
62+
63+
### Request
64+
65+
The following example shows a request.
66+
<!-- {
67+
"blockType": "request",
68+
"name": "update_recommendationconfiguration"
69+
}
70+
-->
71+
``` http
72+
PATCH https://graph.microsoft.com/beta/directory/recommendationConfiguration
73+
Content-Type: application/json
74+
75+
{
76+
"isNotificationEnabled": true
77+
}
78+
```
79+
80+
### Response
81+
82+
The following example shows the response.
83+
>**Note:** The response object shown here might be shortened for readability.
84+
<!-- {
85+
"blockType": "response",
86+
"truncated": true
87+
}
88+
-->
89+
``` http
90+
HTTP/1.1 204 OK
91+
Content-Type: application/json
92+
```

‎api-reference/beta/api/teamsadministration-teamsadminroot-list-userconfigurations.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Namespace: microsoft.graph.teamsAdministration
1616

1717
Get [user configurations](../resources/teamsadministration-teamsuserconfiguration.md) for all Teams users who belong to a tenant.
1818

19+
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
20+
1921
## Permissions
2022

2123
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).

‎api-reference/beta/api/teamsadministration-teamsuserconfiguration-get.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Namespace: microsoft.graph.teamsAdministration
1616

1717
Read the Teams user configurations for a specific user using their ID (the user's identifier).
1818

19+
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
20+
1921
## Permissions
2022

2123
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).

‎api-reference/beta/includes/permissions/authenticationmethodsroot-list-userregistrationdetails-permissions.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.localizationpriority: medium
66

77
|Permission type|Least privileged permissions|Higher privileged permissions|
88
|:---|:---|:---|
9-
|Delegated (work or school account)|AuditLog.Read.All|UserAuthenticationMethod.Read.All|
9+
|Delegated (work or school account)|AuditLog.Read.All|Not available.|
1010
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
11-
|Application|AuditLog.Read.All|UserAuthenticationMethod.Read.All|
11+
|Application|AuditLog.Read.All|Not available.|
1212

‎api-reference/beta/includes/permissions/recommendationconfiguration-get-permissions.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
description: Automatically generated file. DO NOT MODIFY
3+
ms.topic: include
4+
ms.localizationpriority: medium
5+
---
6+
7+
|Permission type|Least privileged permissions|Higher privileged permissions|
8+
|:---|:---|:---|
9+
|Delegated (work or school account)|DirectoryRecommendations.Read.All|Not available.|
10+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
11+
|Application|DirectoryRecommendations.Read.All|Not available.|
12+
13+

‎api-reference/beta/includes/permissions/recommendationconfiguration-update-permissions.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
description: Automatically generated file. DO NOT MODIFY
3+
ms.topic: include
4+
ms.localizationpriority: medium
5+
---
6+
7+
|Permission type|Least privileged permissions|Higher privileged permissions|
8+
|:---|:---|:---|
9+
|Delegated (work or school account)|DirectoryRecommendations.ReadWrite.All|Not available.|
10+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
11+
|Application|DirectoryRecommendations.ReadWrite.All|Not available.|
12+
13+

‎api-reference/beta/includes/permissions/userregistrationdetails-get-permissions.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.localizationpriority: medium
66

77
|Permission type|Least privileged permissions|Higher privileged permissions|
88
|:---|:---|:---|
9-
|Delegated (work or school account)|AuditLog.Read.All|UserAuthenticationMethod.Read.All|
9+
|Delegated (work or school account)|AuditLog.Read.All|Not available.|
1010
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
11-
|Application|AuditLog.Read.All|UserAuthenticationMethod.Read.All|
11+
|Application|AuditLog.Read.All|Not available.|
1212

‎api-reference/beta/includes/rbac-for-apis/rbac-directory-recommendations-configuration-apis-write.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
---
2+
author: mbrndiar
3+
ms.topic: include
4+
---
5+
6+
> [!IMPORTANT]
7+
> In delegated scenarios with work or school accounts, the signed-in user must be assigned a supported [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) or a custom role with a supported role permission. *Security Administrator* is the least privileged role supported for this operation.

‎api-reference/beta/resources/recommendationconfiguration.md

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
---
2+
title: "recommendationConfiguration resource type"
3+
description: "Represents the configuration for recommendation notifications."
4+
author: "mbrndiar"
5+
ms.date: 04/23/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-monitoring-health"
8+
doc_type: resourcePageType
9+
---
10+
11+
# recommendationConfiguration resource type
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Represents the configuration for recommendation notifications. This resource type is used to manage the notification settings for recommendations in Microsoft Entra ID.
18+
It allows you to enable or disable notifications for recommendations, which can help organizations stay informed about important security and compliance issues.
19+
20+
## Methods
21+
22+
|Method|Return type|Description|
23+
|:---|:---|:---|
24+
|[Get](../api/recommendationconfiguration-get.md)|[recommendationConfiguration](../resources/recommendationconfiguration.md)|Read the properties of a recommendationConfiguration object.|
25+
|[Update](../api/recommendationconfiguration-update.md)|None|Update the properties of a recommendationConfiguration object.|
26+
27+
## Properties
28+
29+
|Property|Type|Description|
30+
|:---|:---|:---|
31+
|isNotificationEnabled|Boolean|Indicates whether notifications for recommendations are enabled.|
32+
33+
## Relationships
34+
35+
None.
36+
37+
## JSON representation
38+
39+
The following JSON representation shows the resource type.
40+
<!-- {
41+
"blockType": "resource",
42+
"keyProperty": "id",
43+
"@odata.type": "microsoft.graph.recommendationConfiguration",
44+
"baseType": "microsoft.graph.entity",
45+
"openType": false
46+
}
47+
-->
48+
``` json
49+
{
50+
"@odata.type": "#microsoft.graph.recommendationConfiguration",
51+
"isNotificationEnabled": "Boolean"
52+
}
53+
```

‎api-reference/beta/toc/reports/toc.yml

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,14 @@ items:
4444
href: ../../api/impactedresource-complete.md
4545
- name: Reactivate
4646
href: ../../api/impactedresource-reactivate.md
47+
- name: Recommendation configuration
48+
items:
49+
- name: Recommendation configuration
50+
href: ../../resources/recommendationconfiguration.md
51+
- name: Get
52+
href: ../../api/recommendationconfiguration-get.md
53+
- name: Update
54+
href: ../../api/recommendationconfiguration-update.md
4755
- name: Microsoft Entra activity reports
4856
items:
4957
- name: AD FS application activity

0 commit comments

Comments
 (0)