Edit

permissionGrantPreApprovalPolicy resource type

  • Article

Namespace: microsoft.graph

Important

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.

A permission grant preapproval policy is used to help administrators granularly control the conditions under which consent can be granted to a specific application.

A permission grant preapproval policy consists of a list of condition sets. An event matches a permission grant preapproval policy if it matches at least one of the condition sets in the conditions list. Inherits from directoryObject.

Methods

Method Return type Description
List permissionGrantPreApprovalPolicies permissionGrantPreApprovalPolicy collection Get a list of the permissionGrantPreApprovalPolicy objects and their properties.
Create permissionGrantPreApprovalPolicy permissionGrantPreApprovalPolicy Create a new permissionGrantPreApprovalPolicy object.
Get permissionGrantPreApprovalPolicy permissionGrantPreApprovalPolicy Read the properties and relationships of a permissionGrantPreApprovalPolicy object.
Update permissionGrantPreApprovalPolicy permissionGrantPreApprovalPolicy Update the properties of a permissionGrantPreApprovalPolicy object.
Delete permissionGrantPreApprovalPolicy None Delete a permissionGrantPreApprovalPolicy object.
List permissionGrantPreApprovalPolicy assigned to servicePrincipal permissionGrantPreApprovalPolicy collection Get permissionGrantPreApprovalPolicy assigned to a service principal.
Assign permissionGrantPreApprovalPolicy to servicePrincipal permissionGrantPreApprovalPolicy collection Assign a permissionGrantPreApprovalPolicy to a service principal.
Remove permissionGrantPreApprovalPolicy from servicePrincipal permissionGrantPreApprovalPolicy collection Remove a permissionGrantPreApprovalPolicy from a service principal.

Properties

Property Type Description
conditions preApprovalDetail collection A list of condition sets describing the conditions under which the permission to grant consent for the app has been preapproved.
deletedDateTime DateTimeOffset Null. Inherited from directoryObject.
id String The unique identifier for the permission grant preapproval policy. Inherited from entity.

Relationships

None.

JSON representation

The following is a JSON representation of the resource.

{
  "@odata.type": "#microsoft.graph.permissionGrantPreApprovalPolicy",
  "id": "String (identifier)",
  "deletedDateTime": "String (timestamp)",
  "conditions": [
    {
      "@odata.type": "microsoft.graph.preApprovalDetail"
    }
  ]
}