Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

Get unifiedRoleManagementPolicy

Namespace: microsoft.graph

Retrieve the details of a role management policy.

This API is available in the following national cloud deployments.

Global service	US Government L4	US Government L5 (DOD)	China operated by 21Vianet
✅	✅	✅	✅

Permissions

One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

For PIM for Microsoft Entra roles

Permission type	Permissions (from least to most privileged)
Delegated (work or school account)	RoleManagementPolicy.Read.Directory, RoleManagement.Read.Directory, RoleManagement.Read.All, RoleManagementPolicy.ReadWrite.Directory, RoleManagement.ReadWrite.Directory
Delegated (personal Microsoft account)	Not supported.
Application	RoleManagementPolicy.Read.Directory, RoleManagement.Read.Directory, RoleManagement.Read.All, RoleManagementPolicy.ReadWrite.Directory, RoleManagement.ReadWrite.Directory

Important

For delegated access using work or school accounts, the signed-in user must be assigned a supported Microsoft Entra role or a custom role that grants the permissions required for this operation. This operation supports the following built-in roles, which provide only the least privilege necessary:

For read operations: Global Reader, Security Operator, Security Reader, Security Administrator, or Privileged Role Administrator
For write operations: Privileged Role Administrator

For PIM for Groups

Permission type	Permissions (from least to most privileged)
Delegated (work or school account)	RoleManagementPolicy.Read.AzureADGroup, RoleManagementPolicy.ReadWrite.AzureADGroup
Delegated (personal Microsoft account)	Not supported.
Application	RoleManagementPolicy.Read.AzureADGroup, RoleManagementPolicy.ReadWrite.AzureADGroup

HTTP request

To retrieve the details of a policy in PIM that can be applied to Microsoft Entra roles or group membership or ownership:

GET /policies/roleManagementPolicies/{unifiedRoleManagementPolicyId}

Optional query parameters

This method supports the $select and $expand OData query parameters to help customize the response. You can also specify the wildcard value * to expand all supported relationships, that is, ?$expand=*. For general information, see OData query parameters.

Request headers

Name	Description
Authorization	Bearer {token}. Required. Learn more about authentication and authorization.

Request body

Don't supply a request body for this method.

Response

If successful, this method returns a 200 OK response code and an unifiedRoleManagementPolicy object in the response body.

Examples

Example 1: Retrieve the details of a policy in PIM for Microsoft Entra roles

Request

GET https://graph.microsoft.com/v1.0/policies/roleManagementPolicies/Directory_cab01047-8ad9-4792-8e42-569340767f1b_70c808b5-0d35-4863-a0ba-07888e99d448


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Policies.RoleManagementPolicies["{unifiedRoleManagementPolicy-id}"].GetAsync();



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	 "context"
	 msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	 //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
roleManagementPolicies, err := graphClient.Policies().RoleManagementPolicies().ByUnifiedRoleManagementPolicyId("unifiedRoleManagementPolicy-id").Get(context.Background(), nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

UnifiedRoleManagementPolicy result = graphClient.policies().roleManagementPolicies().byUnifiedRoleManagementPolicyId("{unifiedRoleManagementPolicy-id}").get();


const options = {
	authProvider,
};

const client = Client.init(options);

let unifiedRoleManagementPolicy = await client.api('/policies/roleManagementPolicies/Directory_cab01047-8ad9-4792-8e42-569340767f1b_70c808b5-0d35-4863-a0ba-07888e99d448')
	.get();


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->policies()->roleManagementPolicies()->byUnifiedRoleManagementPolicyId('unifiedRoleManagementPolicy-id')->get()->wait();


Import-Module Microsoft.Graph.Identity.SignIns

Get-MgPolicyRoleManagementPolicy -UnifiedRoleManagementPolicyId $unifiedRoleManagementPolicyId


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.policies.role_management_policies.by_unified_role_management_policy_id('unifiedRoleManagementPolicy-id').get()

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
 "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#policies/roleManagementPolicies/$entity",
 "id": "Directory_cab01047-8ad9-4792-8e42-569340767f1b_70c808b5-0d35-4863-a0ba-07888e99d448",
 "displayName": "Directory",
 "description": "Directory",
 "isOrganizationDefault": false,
 "scopeId": "/",
 "scopeType": "Directory",
 "lastModifiedDateTime": null,
 "lastModifiedBy": {
 "displayName": null,
 "id": null
 }
}

Example 2: Retrieve the details of a policy in PIM for Microsoft Entra roles and expand the relationships

Request

GET https://graph.microsoft.com/v1.0/policies/roleManagementPolicies/DirectoryRole_cab01047-8ad9-4792-8e42-569340767f1b_70c808b5-0d35-4863-a0ba-07888e99d448?$expand=effectiveRules,rules


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Policies.RoleManagementPolicies["{unifiedRoleManagementPolicy-id}"].GetAsync((requestConfiguration) =>
{
	requestConfiguration.QueryParameters.Expand = new string []{ "effectiveRules","rules" };
});



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	 "context"
	 msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	 graphpolicies "github.com/microsoftgraph/msgraph-sdk-go/policies"
	 //other-imports
)

requestParameters := &graphpolicies.RoleManagementPoliciesItemRequestBuilderGetQueryParameters{
	Expand: [] string {"effectiveRules","rules"},
}
configuration := &graphpolicies.RoleManagementPoliciesItemRequestBuilderGetRequestConfiguration{
	QueryParameters: requestParameters,
}

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
roleManagementPolicies, err := graphClient.Policies().RoleManagementPolicies().ByUnifiedRoleManagementPolicyId("unifiedRoleManagementPolicy-id").Get(context.Background(), configuration)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

UnifiedRoleManagementPolicy result = graphClient.policies().roleManagementPolicies().byUnifiedRoleManagementPolicyId("{unifiedRoleManagementPolicy-id}").get(requestConfiguration -> {
	requestConfiguration.queryParameters.expand = new String []{"effectiveRules", "rules"};
});


const options = {
	authProvider,
};

const client = Client.init(options);

let unifiedRoleManagementPolicy = await client.api('/policies/roleManagementPolicies/DirectoryRole_cab01047-8ad9-4792-8e42-569340767f1b_70c808b5-0d35-4863-a0ba-07888e99d448')
	.expand('effectiveRules,rules')
	.get();


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Policies\RoleManagementPolicies\Item\UnifiedRoleManagementPolicyItemRequestBuilderGetRequestConfiguration;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestConfiguration = new UnifiedRoleManagementPolicyItemRequestBuilderGetRequestConfiguration();
$queryParameters = UnifiedRoleManagementPolicyItemRequestBuilderGetRequestConfiguration::createQueryParameters();
$queryParameters->expand = ["effectiveRules","rules"];
$requestConfiguration->queryParameters = $queryParameters;


$result = $graphServiceClient->policies()->roleManagementPolicies()->byUnifiedRoleManagementPolicyId('unifiedRoleManagementPolicy-id')->get($requestConfiguration)->wait();


Import-Module Microsoft.Graph.Identity.SignIns

Get-MgPolicyRoleManagementPolicy -UnifiedRoleManagementPolicyId $unifiedRoleManagementPolicyId -ExpandProperty "effectiveRules,rules"


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.policies.role_management_policies.item.unified_role_management_policy_item_request_builder import UnifiedRoleManagementPolicyItemRequestBuilder
from kiota_abstractions.base_request_configuration import RequestConfiguration
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
query_params = UnifiedRoleManagementPolicyItemRequestBuilder.UnifiedRoleManagementPolicyItemRequestBuilderGetQueryParameters(
		expand = ["effectiveRules","rules"],
)

request_configuration = RequestConfiguration(
query_parameters = query_params,
)

result = await graph_client.policies.role_management_policies.by_unified_role_management_policy_id('unifiedRoleManagementPolicy-id').get(request_configuration = request_configuration)

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
 "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#policies/roleManagementPolicies(effectiveRules(),rules())/$entity",
 "id": "DirectoryRole_cab01047-8ad9-4792-8e42-569340767f1b_70c808b5-0d35-4863-a0ba-07888e99d448",
 "displayName": "DirectoryRole",
 "description": "DirectoryRole",
 "isOrganizationDefault": false,
 "scopeId": "/",
 "scopeType": "DirectoryRole",
 "lastModifiedDateTime": null,
 "lastModifiedBy": {
 "displayName": null,
 "id": null
 },
 "effectiveRules": [
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyExpirationRule",
 "id": "Expiration_Admin_Eligibility",
 "isExpirationRequired": false,
 "maximumDuration": "P365D",
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Eligibility",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyEnablementRule",
 "id": "Enablement_Admin_Eligibility",
 "enabledRules": [],
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Eligibility",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Admin_Admin_Eligibility",
 "notificationType": "Email",
 "recipientType": "Admin",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Eligibility",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Requestor_Admin_Eligibility",
 "notificationType": "Email",
 "recipientType": "Requestor",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Eligibility",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Approver_Admin_Eligibility",
 "notificationType": "Email",
 "recipientType": "Approver",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Eligibility",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyExpirationRule",
 "id": "Expiration_Admin_Assignment",
 "isExpirationRequired": false,
 "maximumDuration": "P180D",
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyEnablementRule",
 "id": "Enablement_Admin_Assignment",
 "enabledRules": [
 "Justification"
 ],
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Admin_Admin_Assignment",
 "notificationType": "Email",
 "recipientType": "Admin",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Requestor_Admin_Assignment",
 "notificationType": "Email",
 "recipientType": "Requestor",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Approver_Admin_Assignment",
 "notificationType": "Email",
 "recipientType": "Approver",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyExpirationRule",
 "id": "Expiration_EndUser_Assignment",
 "isExpirationRequired": true,
 "maximumDuration": "PT8H",
 "target": {
 "caller": "EndUser",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyEnablementRule",
 "id": "Enablement_EndUser_Assignment",
 "enabledRules": [
 "MultiFactorAuthentication",
 "Justification"
 ],
 "target": {
 "caller": "EndUser",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyApprovalRule",
 "id": "Approval_EndUser_Assignment",
 "target": {
 "caller": "EndUser",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 },
 "setting": {
 "isApprovalRequired": false,
 "isApprovalRequiredForExtension": false,
 "isRequestorJustificationRequired": true,
 "approvalMode": "SingleStage",
 "approvalStages": [
 {
 "approvalStageTimeOutInDays": 1,
 "isApproverJustificationRequired": true,
 "escalationTimeInMinutes": 0,
 "isEscalationEnabled": false,
 "primaryApprovers": [],
 "escalationApprovers": []
 }
 ]
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyAuthenticationContextRule",
 "id": "AuthenticationContext_EndUser_Assignment",
 "isEnabled": false,
 "claimValue": null,
 "target": {
 "caller": "EndUser",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Admin_EndUser_Assignment",
 "notificationType": "Email",
 "recipientType": "Admin",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "EndUser",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Requestor_EndUser_Assignment",
 "notificationType": "Email",
 "recipientType": "Requestor",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "EndUser",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Approver_EndUser_Assignment",
 "notificationType": "Email",
 "recipientType": "Approver",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "EndUser",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 }
 ],
 "rules": [
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyExpirationRule",
 "id": "Expiration_Admin_Eligibility",
 "isExpirationRequired": false,
 "maximumDuration": "P365D",
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Eligibility",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyEnablementRule",
 "id": "Enablement_Admin_Eligibility",
 "enabledRules": [],
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Eligibility",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Admin_Admin_Eligibility",
 "notificationType": "Email",
 "recipientType": "Admin",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Eligibility",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Requestor_Admin_Eligibility",
 "notificationType": "Email",
 "recipientType": "Requestor",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Eligibility",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Approver_Admin_Eligibility",
 "notificationType": "Email",
 "recipientType": "Approver",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Eligibility",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyExpirationRule",
 "id": "Expiration_Admin_Assignment",
 "isExpirationRequired": false,
 "maximumDuration": "P180D",
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyEnablementRule",
 "id": "Enablement_Admin_Assignment",
 "enabledRules": [
 "Justification"
 ],
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Admin_Admin_Assignment",
 "notificationType": "Email",
 "recipientType": "Admin",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Requestor_Admin_Assignment",
 "notificationType": "Email",
 "recipientType": "Requestor",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Approver_Admin_Assignment",
 "notificationType": "Email",
 "recipientType": "Approver",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "Admin",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyExpirationRule",
 "id": "Expiration_EndUser_Assignment",
 "isExpirationRequired": true,
 "maximumDuration": "PT8H",
 "target": {
 "caller": "EndUser",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyEnablementRule",
 "id": "Enablement_EndUser_Assignment",
 "enabledRules": [
 "MultiFactorAuthentication",
 "Justification"
 ],
 "target": {
 "caller": "EndUser",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyApprovalRule",
 "id": "Approval_EndUser_Assignment",
 "target": {
 "caller": "EndUser",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 },
 "setting": {
 "isApprovalRequired": false,
 "isApprovalRequiredForExtension": false,
 "isRequestorJustificationRequired": true,
 "approvalMode": "SingleStage",
 "approvalStages": [
 {
 "approvalStageTimeOutInDays": 1,
 "isApproverJustificationRequired": true,
 "escalationTimeInMinutes": 0,
 "isEscalationEnabled": false,
 "primaryApprovers": [],
 "escalationApprovers": []
 }
 ]
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyAuthenticationContextRule",
 "id": "AuthenticationContext_EndUser_Assignment",
 "isEnabled": false,
 "claimValue": null,
 "target": {
 "caller": "EndUser",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Admin_EndUser_Assignment",
 "notificationType": "Email",
 "recipientType": "Admin",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "EndUser",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Requestor_EndUser_Assignment",
 "notificationType": "Email",
 "recipientType": "Requestor",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "EndUser",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 },
 {
 "@odata.type": "#microsoft.graph.unifiedRoleManagementPolicyNotificationRule",
 "id": "Notification_Approver_EndUser_Assignment",
 "notificationType": "Email",
 "recipientType": "Approver",
 "notificationLevel": "All",
 "isDefaultRecipientsEnabled": true,
 "notificationRecipients": [],
 "target": {
 "caller": "EndUser",
 "operations": [
 "all"
 ],
 "level": "Assignment",
 "inheritableSettings": [],
 "enforcedSettings": []
 }
 }
 ]
}

Example 3: Retrieve the details of a policy in PIM for Groups

Request

The following example shows a request.

GET https://graph.microsoft.com/v1.0/policies/roleManagementPolicies/Group_60bba733-f09d-49b7-8445-32369aa066b3_f21b26d9-9ff9-4af1-b1d4-bddf28591369


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Policies.RoleManagementPolicies["{unifiedRoleManagementPolicy-id}"].GetAsync();



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	 "context"
	 msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	 //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
roleManagementPolicies, err := graphClient.Policies().RoleManagementPolicies().ByUnifiedRoleManagementPolicyId("unifiedRoleManagementPolicy-id").Get(context.Background(), nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

UnifiedRoleManagementPolicy result = graphClient.policies().roleManagementPolicies().byUnifiedRoleManagementPolicyId("{unifiedRoleManagementPolicy-id}").get();


const options = {
	authProvider,
};

const client = Client.init(options);

let unifiedRoleManagementPolicy = await client.api('/policies/roleManagementPolicies/Group_60bba733-f09d-49b7-8445-32369aa066b3_f21b26d9-9ff9-4af1-b1d4-bddf28591369')
	.get();


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->policies()->roleManagementPolicies()->byUnifiedRoleManagementPolicyId('unifiedRoleManagementPolicy-id')->get()->wait();


Import-Module Microsoft.Graph.Identity.SignIns

Get-MgPolicyRoleManagementPolicy -UnifiedRoleManagementPolicyId $unifiedRoleManagementPolicyId


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.policies.role_management_policies.by_unified_role_management_policy_id('unifiedRoleManagementPolicy-id').get()

Response

The following example shows the response.

HTTP/1.1 200 OK
Content-Type: application/json

{
 "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#policies/roleManagementPolicies/$entity",
 "id": "Group_60bba733-f09d-49b7-8445-32369aa066b3_f21b26d9-9ff9-4af1-b1d4-bddf28591369",
 "displayName": "Group",
 "description": "Group",
 "isOrganizationDefault": false,
 "scopeId": "60bba733-f09d-49b7-8445-32369aa066b3",
 "scopeType": "Group",
 "lastModifiedDateTime": "2023-05-23T23:29:43.687Z",
 "lastModifiedBy": {
 "displayName": null,
 "id": null
 }
}

Feedback

Was this page helpful?

Additional resources

Last updated on

URL: https://learn.microsoft.com/en-us/graph/api/unifiedrolemanagementpolicy-get?view=graph-rest-1.0