Skip to content

Commit 0af66a5

Browse files
DanielabomDanielabom
authored
Merge pull request #26617 from microsoftgraph/main
Mege to publish.
2 parents 7ec678e + 8a70142 commit 0af66a5

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)