Skip to content

Commit e5e838b

Browse files
authored
Merge branch 'main' into snippet-generation/178246
2 parents 736bc11 + d348abc commit e5e838b

6 files changed

+315
-208
lines changed

api-reference/beta/api/directoryobject-checkmembergroups.md

Lines changed: 57 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,15 @@ Namespace: microsoft.graph
1414

1515
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
1616

17-
Check for membership in a specified list of group IDs, and return from that list those groups (identified by IDs) of which the specified [user](../resources/user.md), [group](../resources/group.md), [service principal](../resources/serviceprincipal.md), [organizational contact](../resources/orgcontact.md), [device](../resources/device.md), or [directory object](../resources/directoryobject.md) is a member. This function is transitive.
17+
Check for membership in a specified list of [group](../resources/group.md) IDs, and return from that list the IDs of groups where a specified object is a member. The specified object can be of one of the following types:
18+
- [user](../resources/user.md)
19+
- [group](../resources/group.md)
20+
- [service principal](../resources/serviceprincipal.md)
21+
- [organizational contact](../resources/orgcontact.md)
22+
- [device](../resources/device.md)
23+
- [directory object](../resources/directoryobject.md)
24+
25+
This function is transitive.
1826

1927
You can check up to a maximum of 20 groups per request. This function supports all groups provisioned in Microsoft Entra ID. Because Microsoft 365 groups cannot contain other groups, membership in a Microsoft 365 group is always direct.
2028

@@ -26,47 +34,68 @@ One of the following permissions is required to call this API. To learn more, in
2634

2735
### Group memberships for a directory object
2836
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
29-
| Permission type | Permissions (from least to most privileged) |
30-
|:---------------------------------------|:------------------------------------------------------|
31-
| Delegated (work or school account) | User.ReadBasic.All, User.Read.All, Directory.Read.All |
32-
| Delegated (personal Microsoft account) | Not supported. |
33-
| Application | User.Read.All, Directory.Read.All |
37+
|Permission type|Least privileged permissions|Higher privileged permissions|
38+
|:---|:---|:---|
39+
|Delegated (work or school account)|Directory.Read.All|Directory.ReadWrite.All |
40+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
41+
|Application|Directory.Read.All|Directory.ReadWrite.All |
42+
43+
> [!NOTE]
44+
> The *Directory.\** permissions allow you to retrieve any supported directory object type via this API. To retrieve only a specific type, you can use permissions specific to the resource.
3445
3546
### Group memberships for the signed-in user
47+
3648
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
37-
| Permission type | Permissions (from least to most privileged) |
38-
|:-|:-|
39-
| Delegated (work or school account) | User.Read, User.ReadBasic.All, User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All |
40-
| Delegated (personal Microsoft account) | Not supported. |
41-
| Application | Not supported. |
49+
|Permission type|Least privileged permissions|Higher privileged permissions|
50+
|:---|:---|:---|
51+
|Delegated (work or school account)|User.Read|User.ReadBasic.All and GroupMember.Read.All, User.Read.All and GroupMember.Read.All, User.ReadBasic.All and Group.Read.All, User.Read.All and Group.Read.All, Directory.Read.All |
52+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
53+
|Application|Not supported.|Not supported.|
4254

4355
### Group memberships for other users
56+
4457
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
45-
| Permission type | Permissions (from least to most privileged) |
46-
|:-|:-|
47-
| Delegated (work or school account) | User.ReadBasic.All, User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All |
48-
| Delegated (personal Microsoft account) | Not supported. |
49-
| Application | User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All |
58+
|Permission type|Least privileged permissions|Higher privileged permissions|
59+
|:---|:---|:---|
60+
|Delegated (work or school account)|User.ReadBasic.All and GroupMember.Read.All|User.Read.All and GroupMember.Read.All, User.ReadBasic.All and Group.Read.All, User.Read.All and Group.Read.All, Directory.Read.All |
61+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
62+
|Application|User.ReadBasic.All and GroupMember.Read.All|User.Read.All and GroupMember.Read.All, User.Read.All and Group.Read.All, Directory.Read.All|
5063

5164
### Group memberships for a group
65+
5266
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
53-
| Permission type | Permissions (from least to most privileged) |
54-
|:-|:-|
55-
| Delegated (work or school account) | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All |
56-
| Delegated (personal Microsoft account) | Not supported. |
57-
| Application | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All |
67+
|Permission type|Least privileged permissions|Higher privileged permissions|
68+
|:---|:---|:---|
69+
|Delegated (work or school account)|GroupMember.Read.All|Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All |
70+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
71+
|Application|GroupMember.Read.All|Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All|
5872

5973
### Group memberships for a service principal
74+
6075
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
61-
|Permission type | Permissions (from least to most privileged) |
62-
|:--------------------|:---------------------------------------------------------|
63-
|Delegated (work or school account) | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All |
64-
|Delegated (personal Microsoft account) | Not supported. |
65-
|Application | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All |
76+
|Permission type|Least privileged permissions|Higher privileged permissions|
77+
|:---|:---|:---|
78+
|Delegated (work or school account)|Application.Read.All|Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All |
79+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
80+
|Application|Application.Read.All|Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All|
6681

6782
### Group memberships for an organizational contact
68-
<!-- { "blockType": "permissions", "name": "directoryobject_checkmembergroups_6" } -->
69-
[!INCLUDE [permissions-table](../includes/permissions/directoryobject-checkmembergroups-6-permissions.md)]
83+
84+
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
85+
|Permission type|Least privileged permissions|Higher privileged permissions|
86+
|:---|:---|:---|
87+
|Delegated (work or school account)|Directory.Read.All|Directory.ReadWrite.All |
88+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
89+
|Application|Directory.Read.All|Directory.ReadWrite.All |
90+
91+
### Group memberships for a device
92+
93+
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
94+
|Permission type|Least privileged permissions|Higher privileged permissions|
95+
|:---|:---|:---|
96+
|Delegated (work or school account)|Device.Read.All|Directory.Read.All, Directory.ReadWrite.All |
97+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
98+
|Application|Device.Read.All|Directory.Read.All, Directory.ReadWrite.All |
7099

71100
## HTTP request
72101

api-reference/beta/api/directoryobject-checkmemberobjects.md

Lines changed: 47 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,15 @@ Namespace: microsoft.graph
1515

1616
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
1717

18-
Check for membership in a list of group IDs, administrative unit IDs, or directory role IDs, for the IDs of the specified [user](../resources/user.md), [group](../resources/group.md), [service principal](../resources/serviceprincipal.md), [organizational contact](../resources/orgcontact.md), [device](../resources/device.md), or [directory object](../resources/directoryobject.md). This method is transitive.
18+
Check for membership in a list of group IDs, administrative unit IDs, or directory role IDs, for the IDs of the specified
19+
- [user](../resources/user.md)
20+
- [group](../resources/group.md)
21+
- [service principal](../resources/serviceprincipal.md)
22+
- [organizational contact](../resources/orgcontact.md)
23+
- [device](../resources/device.md)
24+
- [directory object](../resources/directoryobject.md).
25+
26+
This method is transitive.
1927

2028
[!INCLUDE [national-cloud-support](../../includes/all-clouds.md)]
2129

@@ -25,60 +33,62 @@ One of the following permissions is required to call this API. To learn more, in
2533

2634
### Memberships for a directory object
2735
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
28-
|Permission type | Permissions (from least to most privileged) |
29-
|:--------------------|:---------------------------------------------------------|
30-
|Delegated (work or school account) | Directory.Read.All |
31-
|Delegated (personal Microsoft account) | Not supported. |
32-
|Application | Directory.Read.All |
36+
|Permission type|Least privileged permissions|Higher privileged permissions|
37+
|:---|:---|:---|
38+
|Delegated (work or school account)|Directory.Read.All|Directory.ReadWrite.All |
39+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
40+
|Application|Directory.Read.All|Directory.ReadWrite.All |
41+
42+
> [!NOTE]
43+
> The *Directory.\** permissions allow you to retrieve any supported directory object type via this API. To retrieve only a specific type, you can use permissions specific to the resource.
3344
3445
### Memberships for the signed-in user
3546
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
36-
|Permission type | Permissions (from least to most privileged) |
37-
|:--------------------|:---------------------------------------------------------|
38-
|Delegated (work or school account) | User.Read, User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All |
39-
|Delegated (personal Microsoft account) | Not supported. |
40-
|Application | Not supported. |
47+
|Permission type|Least privileged permissions|Higher privileged permissions|
48+
|:---|:---|:---|
49+
|Delegated (work or school account)|User.Read|User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All |
50+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
51+
|Application|Not supported.|Not supported.|
4152

4253
### Memberships for other users
4354
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
44-
|Permission type | Permissions (from least to most privileged) |
45-
|:--------------------|:---------------------------------------------------------|
46-
|Delegated (work or school account) | User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All |
47-
|Delegated (personal Microsoft account) | Not supported. |
48-
|Application | User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All |
55+
|Permission type|Least privileged permissions|Higher privileged permissions|
56+
|:---|:---|:---|
57+
|Delegated (work or school account)|User.ReadBasic.All and GroupMember.Read.All|User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All |
58+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
59+
|Application|User.ReadBasic.All and GroupMember.Read.All|User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All|
4960

5061
### Memberships for a group
5162
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
52-
| Permission type | Permissions (from least to most privileged) |
53-
| :------------------------------------- | :------------------------------------------------------------------------------------------ |
54-
| Delegated (work or school account) | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All |
55-
| Delegated (personal Microsoft account) | Not supported. |
56-
| Application | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All |
63+
|Permission type|Least privileged permissions|Higher privileged permissions|
64+
|:---|:---|:---|
65+
|Delegated (work or school account)|GroupMember.Read.All|Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All |
66+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
67+
|Application|GroupMember.Read.All|Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All|
5768

5869
### Memberships for a service principal
5970
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
60-
|Permission type | Permissions (from least to most privileged) |
61-
|:--------------------|:---------------------------------------------------------|
62-
|Delegated (work or school account) | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All |
63-
|Delegated (personal Microsoft account) | Not supported. |
64-
|Application | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All |
71+
|Permission type|Least privileged permissions|Higher privileged permissions|
72+
|:---|:---|:---|
73+
|Delegated (work or school account)|Application.Read.All|Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All |
74+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
75+
|Application|Application.Read.All|Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All|
6576

6677
### Memberships for an organizational contact
6778
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
68-
|Permission type | Permissions (from least to most privileged) |
69-
|:--------------------|:---------------------------------------------------------|
70-
|Delegated (work or school account) | Directory.Read.All, Directory.ReadWrite.All |
71-
|Delegated (personal Microsoft account) | Not supported. |
72-
|Application | Directory.Read.All, Directory.ReadWrite.All |
79+
|Permission type|Least privileged permissions|Higher privileged permissions|
80+
|:---|:---|:---|
81+
|Delegated (work or school account)|Directory.Read.All|Directory.ReadWrite.All |
82+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
83+
|Application|Directory.Read.All|Directory.ReadWrite.All |
7384

7485
### Memberships for a device
7586
<!-- { "blockType": "ignored" } // Note: Removing this line will result in the permissions autogeneration tool overwriting the table. -->
76-
| Permission type | Permissions (from least to most privileged) |
77-
|:---------------------------------------|:--------------------------------------------|
78-
| Delegated (work or school account) | Device.Read.All, Directory.Read.All, Directory.ReadWrite.All |
79-
| Delegated (personal Microsoft account) | Not supported. |
80-
| Application | Device.Read.All, Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
81-
87+
|Permission type|Least privileged permissions|Higher privileged permissions|
88+
|:---|:---|:---|
89+
|Delegated (work or school account)|Device.Read.All|Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
90+
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
91+
|Application|Device.Read.All|Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
8292

8393
## HTTP request
8494

0 commit comments

Comments
 (0)