member_of

Creates, updates, deletes, gets or lists a member_of resource.

Overview

Name	member_of
Type	Resource
Id	entra_id.service_principals.member_of

Fields

The following fields are returned by SELECT queries:

get

Retrieved navigation property

Name	Datatype	Description
id	string	The unique identifier for an entity. Read-only.
deletedDateTime	string (date-time)	Date and time when this object was deleted. Always null when the object hasn't been deleted. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$)

list

Retrieved collection

Name	Datatype	Description
id	string	The unique identifier for an entity. Read-only.
deletedDateTime	string (date-time)	Date and time when this object was deleted. Always null when the object hasn't been deleted. (pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	service_principal_id, directory_object_id	ConsistencyLevel	Roles that this service principal is a member of. HTTP Methods: GET Read-only. Nullable. Supports $expand.
list	select	service_principal_id	ConsistencyLevel	Get the groups and directory roles that this servicePrincipal is a direct member of. This operation is not transitive.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
directory_object_id	string	The unique identifier of directoryObject
service_principal_id	string	The unique identifier of servicePrincipal
ConsistencyLevel	string	Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries

SELECT examples

get

Roles that this service principal is a member of. HTTP Methods: GET Read-only. Nullable. Supports $expand.

SELECT
id,
deletedDateTime
FROM entra_id.service_principals.member_of
WHERE service_principal_id = '{{ service_principal_id }}' -- required
AND directory_object_id = '{{ directory_object_id }}' -- required
AND ConsistencyLevel = '{{ ConsistencyLevel }}'
;

list

Get the groups and directory roles that this servicePrincipal is a direct member of. This operation is not transitive.

SELECT
id,
deletedDateTime
FROM entra_id.service_principals.member_of
WHERE service_principal_id = '{{ service_principal_id }}' -- required
AND ConsistencyLevel = '{{ ConsistencyLevel }}'
;