appManagementPolicy resource type

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.

Restrictions on app management operations for specific applications and service principals. If this resource is not configured for an application or service principal, the restrictions default to the settings in the tenantAppManagementPolicy object.

To learn more about how to use app management policy, see Microsoft Entra application authentication methods API overview.

Methods

Method Return type Description
List appManagementPolicy collection Returns a list of app management policies created for applications and service principals along with their properties.
Create appManagementPolicy Creates an app management policy that can be assigned to an application or service principal object.
Get appManagementPolicy Gets a single app management policy object.
Update None Updates an app management policy.
Delete None Deletes an app management policy from the collection of policies in appManagementPolicies.
List applies to appManagementPolicy Returns a list of applications and service principals to which the policy is applied.
Create applies to None Returns a list of applications and service principals to which the policy is applied.

Properties

Property Type Description
description String The description of the policy. Inherited from policyBase.
displayName String The display name of the policy. Inherited from policyBase.
id String The unique identifier for the policy.
isEnabled Boolean Denotes whether the policy is enabled.
restrictions customAppManagementConfiguration Restrictions that apply to an application or service principal object.

Relationships

Relationship Type Description
appliesTo directoryObject Collection of application and service principals to which a policy is applied.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/appManagementPolicies",
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "isEnabled": "Boolean",
  "restrictions": {"@odata.type": "microsoft.graph.customAppManagementConfiguration"}
}