privilegedRole resource type


APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported.

Represents an Azure AD administrator role, such as: Global Administrator, Billing Administrator, Service Administrator, User Administrator, Password Administrator, etc.


Method Return Type Description
List privilegedRole objects privilegedRole collection Get the collection of privilegedRole.
Get privilegedRole privilegedRole Read properties and relationships of privilegedRole object.
List assignments privilegedRoleAssignment collection Get a assignment object collection for this role.
selfActivate privilegedRoleAssignment Activate the assigned role.
selfDeactivate privilegedRoleAssignment Deactivate the assigned role.


Property Type Description
id string The unique identifier for administrator role. It is a GUID string and has the same value as the role template id from Azure AD for the given role. Read-only.
name string Role name.


Relationship Type Description
assignments privilegedRoleAssignment collection The assignments for this role. Read-only. Nullable.
settings privilegedRoleSettings The settings for this role. Read-only. Nullable.
summary privilegedRoleSummary The summary information for this role. Read-only. Nullable.

JSON representation

Here is a JSON representation of the resource.

  "id": "string (identifier)",
  "name": "string"