title | description | ms.localizationpriority | author | ms.subservice | doc_type |
---|---|---|---|---|---|
approvalStage complex type |
In entitlement management, used for the approvalStages property of approval settings in the requestApprovalSettings property of an access package assignment policy. Specifies the primary, fallback, and escalation approvers of each stage. In PIM, defines the settings of the approval stages in a unifiedRoleManagementPolicyApprovalRule object. |
medium |
markwahl-msft |
entra-id-governance |
resourcePageType |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
In entitlement management, used for the approvalStages property of approval settings in the requestApprovalSettings property of an access package assignment policy. Specifies the primary, fallback, and escalation approvers of each stage.
In PIM, defines the settings of the approval stages in a unifiedRoleManagementPolicyApprovalRule object. Specifies the primary and escalation approvers of each stage and whether approvals and escalations are required.
Property | Type | Description |
---|---|---|
approvalStageTimeOutInDays | Int32 | The number of days that a request can be pending a response before it's automatically denied. |
isApproverJustificationRequired | Boolean | Indicates whether the approver is required to provide a justification for approving a request. |
isEscalationEnabled | Boolean | If true, then one or more escalation approvers are configured in this approval stage. |
escalationTimeInMinutes | Int32 | If escalation is required, the time a request can be pending a response from a primary approver. |
primaryApprovers | userSet collection | The users who are asked to approve requests. A collection of singleUser, groupMembers, requestorManager, internalSponsors, externalSponsors and targetUserSponsors. When creating or updating a policy, include at least one userSet in this collection. |
escalationApprovers | userSet collection | If escalation is enabled and the primary approvers don't respond before the escalation time, the escalationApprovers are the users who will be asked to approve requests. This can be a collection of singleUser, groupMembers, requestorManager, internalSponsors and externalSponsors. When creating or updating a policy, if there are no escalation approvers, or escalation approvers aren't required for the stage, the value of this property should be an empty collection. |
Here's a JSON representation of the request approval stage.
{
"approvalStageTimeOutInDays": 14,
"isApproverJustificationRequired": true,
"isEscalationEnabled": true,
"escalationTimeInMinutes": 11520,
"primaryApprovers": [{"@odata.type": "microsoft.graph.userSet"}],
"escalationApprovers": [{"@odata.type": "microsoft.graph.userSet"}]
}