governanceRoleAssignmentRequest resource type

Namespace: microsoft.graph


APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.


This version of the Privileged Identity Management (PIM) API for Azure resources will be deprecated soon. Please use the new Azure REST PIM API for Azure resource roles.

Represents the request for role assignment operations in Privileged Identity Management.

governanceRoleAssignmentRequest is a ticket-modeled entity used to manage the lifecycle of role assignments. It represents the intention/decision of the users and administrators, and also provides the flexibility to enable implementation of recurrent schduling, approval gates, and so on, as compared to directly exposing POST, PUT, and DELETE operations on governanceRoleAssignment.


Method Return Type Description
Get governanceRoleAssignmentRequest Get a role assignment request specified by ID.
List governanceRoleAssignmentRequest collection Get role assignment requests on a resource.
Create governanceRoleAssignmentRequest Create a request to manage the lifecycle of existing or new role assignment.
Cancel Cancel a pending role assignment request.
Update governanceRoleAssignmentRequest Administrators update the decisions on requests if the requests are in status of PendingAdminDecision.


Property Type Description
id String The identifier of the role assignment request.
resourceId String Required. The unique identifier of the Azure resource that is associated with the role assignment request. Azure resources can include subscriptions, resource groups, virtual machines, and SQL databases.
roleDefinitionId String Required. The identifier of the Azure role definition that the role assignment request is associated with.
subjectId String Required. The unique identifier of the principal or subject that the role assignment request is associated with. Principals can be users, groups, or service principals.
type String Required. Representing the type of the operation on the role assignment. The possible values are: AdminAdd , UserAdd , AdminUpdate , AdminRemove , UserRemove , UserExtend , AdminExtend , UserRenew , AdminRenew.
assignmentState String Required. The state of the assignment. The possible values are: Eligible (for eligible assignment), Active (if it is directly assigned), Active (by administrators, or activated on an eligible assignment by the users).
requestedDateTime DateTimeOffset Read-only. The request create time. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
schedule governanceSchedule The schedule object of the role assignment request.
reason String A message provided by users and administrators when create the request about why it is needed.
status governanceRoleAssignmentRequestStatus The status of the role assignment request.
linkedEligibleRoleAssignmentId String If this is a request for role activation, it represents the id of the eligible assignment being referred; Otherwise, the value is null.
Member Description
AdminAdd Administrators assign users/groups to roles.
UserAdd Users activate eligible assignments.
AdminUpdate Administrators change existing role assignments.
AdminRemove Administrators remove users/groups from roles.
UserRemove Users deactivate active assignments.
UserExtend Users request to extend their expiring assignments.
AdminExtend Administrators extend expiring assignments.
UserRenew Users request to renew their expired assignments.
AdminRenew Administrators extend expiring assignments.


Relationship Type Description
resource governanceResource Read-only. The resource that the request aims to.
roleDefinition governanceRoleDefinition Read-only. The role definition that the request aims to.
subject governanceSubject Read-only. The user/group principal.

JSON representation

Here is a JSON representation of the resource.

  "id": "String (identifier)",
  "resourceId": "String",
  "roleDefinitionId": "String",
  "subjectId": "String",
  "type": "String",
  "assignmentState": "String",
  "reason": "String",
  "requestedDateTime": "String (timestamp)",
  "schedule": {"@odata.type": "microsoft.graph.governanceSchedule"},
  "status": {"@odata.type": "microsoft.graph.governanceRoleAssignmentRequestStatus"},
  "linkedEligibleRoleAssignmentId": "String"