Get unifiedRoleAssignmentMultiple
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.
Get the properties and relationships of a unifiedRoleAssignmentMultiple object of an RBAC provider.
The following RBAC providers are currently supported:
- Cloud PC
- device management (Intune)
For other Microsoft 365 applications (like Azure AD), use unifiedRoleAssignment.
Permissions
Depending on the RBAC provider and the permission type (delegated or application) that is needed, choose from the following table the least privileged permission required to call this API. To learn more, including taking caution before choosing more privileged permissions, see Permissions.
For Cloud PC provider
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | CloudPC.Read.All, CloudPC.ReadWrite.All |
Delegated (personal Microsoft account) | Not supported. |
Application | CloudPC.Read.All, CloudPC.ReadWrite.All |
For Device management (Intune) provider
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | DeviceManagementRBAC.Read.All, DeviceManagementRBAC.ReadWrite.All |
Delegated (personal Microsoft account) | Not supported. |
Application | DeviceManagementRBAC.Read.All, DeviceManagementRBAC.ReadWrite.All |
HTTP request
To get the properties and relationships of a unifiedRoleAssignmentMultiple for a Cloud PC provider:
GET /roleManagement/cloudPC/roleAssignments/{id}
To get the properties and relationships of a unifiedRoleAssignmentMultiple for an Intune provider:
GET /roleManagement/deviceManagement/roleAssignments/{id}
Optional query parameters
This method supports OData query parameters to help customize the response. For general information, see OData query parameters.
Request headers
Name | Description |
---|---|
Authorization | Bearer {token}. Required. |
Request body
Do not supply a request body for this method.
Response
If successful, this method returns a 200 OK
response code and the requested unifiedRoleAssignmentMultiple object in the response body.
Examples
Example 1: Get a directory-scoped roleAssignmentMultiple in an Intune provider
Request
The following is an example of the request.
GET https://graph.microsoft.com/beta/roleManagement/deviceManagement/roleAssignments/lAPpYvVpN0KRkAEhdxReEJC2sEqbR_9Hr48lds9SGHI-1
Response
The following is an example of the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#roleManagement/deviceManagement/roleAssignments/$entity",
"@odata.type": "#microsoft.graph.unifiedRoleAssignmentMultiple",
"id": "lAPpYvVpN0KRkAEhdxReEJC2sEqbR_9Hr48lds9SGHI-1",
"roleDefinitionId": "62e90394-69f5-4237-9190-012177145e10",
"principalIds[]": ["4ab0b690-479b-47ff-af8f-2576cf521872", "f8ca5a85-489a-49a0-b555-0a6d81e56f0d"],
"directoryScopeIds[]": ["28ca5a85-489a-49a0-b555-0a6d81e56f0", "8152656a-cf9a-4928-a457-1512d4cae295"]
}
Example 2: Get a roleAssignmentMultiple assigned to a group in an Intune provider
Request
The following is an example of the request.
GET https://graph.microsoft.com/beta/roleManagement/deviceManagement/roleAssignments?$filter = principalIds/any(x:x eq '564ae70c-73d9-476b-820b-fb61eb7384b9')
Response
The following is an example of the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#roleManagement/deviceManagement/roleAssignments",
"@odata.count": 7,
"value": [
{
"id": "893fc648-73fc-482b-b964-ddd1cabf0db4",
"condition": null,
"displayName": "Assign Contoso_App_Admin to School Admin",
"description": "test",
"roleDefinitionId": "2f9f4f7e-2d13-427b-adf2-361a1eef7ae8",
"principalIds": [
"564ae70c-73d9-476b-820b-fb61eb7384b9"
],
"directoryScopeIds": [],
"appScopeIds": [
"0",
"AllLicensedUsers"
]
}
]
}
Example 3: Get a directory-scoped roleAssignmentMultiple in an Intune provider with $expand
Request
The following is an example of the request with the $expand
query parameter.
GET https://graph.microsoft.com/beta/roleManagement/deviceManagement/roleAssignments/lAPpYvVpN0KRkAEhdxReEJC2sEqbR_9Hr48lds9SGHI-1?$expand=roleDefinition,principals,directoryScopes
Response
The following is an example of the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#roleManagement/deviceManagement/roleAssignments/$entity",
"@odata.type": "#microsoft.graph.unifiedRoleAssignmentMultiple",
"id": "lAPpYvVpN0KRkAEhdxReEJC2sEqbR_9Hr48lds9SGHI-1",
"roleDefinitionId": "c2cf284d-6c41-4e6b-afac-4b80928c9034",
"roleDefinition": {
"id": "c2cf284d-6c41-4e6b-afac-4b80928c9034",
"displayName": "Application Manager",
"description": "Manages mobile and managed applications",
"rolePermissions": [
{
"allowedResourceActions": [],
"excludedResourceActions": [],
}],
"isEnabled": true,
"isBuiltIn": true,
},
"principalIds": ["f8ca5a85-489a-49a0-b555-0a6d81e56f0d", "c1518aa9-4da5-4c84-a902-a31404023890"],
"principals": [
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#groups/$entity",
"id": "f8ca5a85-489a-49a0-b555-0a6d81e56f0d",
"displayName": "Global IT"
},
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#groups/$entity",
"id": "c1518aa9-4da5-4c84-a902-a31404023890",
"displayName": "Americas IT"
}
],
"directoryScopeIds": ["28ca5a85-489a-49a0-b555-0a6d81e56f0d", "8152656a-cf9a-4928-a457-1512d4cae295"],
"directoryScopes": [
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#groups/$entity",
"id": "28ca5a85-489a-49a0-b555-0a6d81e56f0d",
"displayName": "Washington Sales Region"
},
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#groups/$entity",
"id": "8152656a-cf9a-4928-a457-1512d4cae295",
"displayName": "Oregon Sales Region"
}
]
}
Example 4: Get a roleAssignmentMultiple in a Cloud PC provider
Request
GET https://graph.microsoft.com/beta/roleManagement/cloudPC/roleAssignments/dbe9d288-fd87-41f4-b33d-b498ed207096
Response
Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#roleManagement/cloudPC/roleAssignments/$entity",
"id": "dbe9d288-fd87-41f4-b33d-b498ed207096",
"description": null,
"displayName": "My test role assignment 1",
"roleDefinitionId": "b5c08161-a7af-481c-ace2-a20a69a48fb1",
"principalIds": [
"8e811502-ebda-4782-8f81-071d17f0f892",
"30e3492f-964c-4d73-88c6-986a53c6e2a0"
],
"directoryScopeIds": [
"/"
],
"appScopeIds": []
}
Example 5: Get a roleAssignmentMultiple in a Cloud PC provider with $expand
Request
The following is an example of the request with the $expand
query parameter.
GET https://graph.microsoft.com/beta/roleManagement/cloudPC/roleAssignments/dbe9d288-fd87-41f4-b33d-b498ed207096?$expand=roleDefinition
Response
Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#roleManagement/cloudPC/roleAssignments/$entity",
"@odata.type": "#microsoft.graph.unifiedRoleAssignmentMultiple",
"id": "dbe9d288-fd87-41f4-b33d-b498ed207096",
"roleDefinitionId": "b5c08161-a7af-481c-ace2-a20a69a48fb1",
"principalIds": ["8e811502-ebda-4782-8f81-071d17f0f892", "30e3492f-964c-4d73-88c6-986a53c6e2a0"],
"directoryScopeIds": [
"/"
],
"appScopeIds": [],
"roleDefinitions": {
"id": "b5c08161-a7af-481c-ace2-a20a69a48fb1",
"description": "Have read and write access to all Cloud PC features.",
"displayName": "Cloud PC Administrator",
"isBuiltIn": true,
"isEnabled": true,
"resourceScopes": [
"/"
],
"templateId": "b5c08161-a7af-481c-ace2-a20a69a48fb1",
"version": null,
"rolePermissions": [
{
"allowedResourceActions": [
"Microsoft.CloudPC/CloudPCs/Read",
"Microsoft.CloudPC/CloudPCs/Reprovision",
"Microsoft.CloudPC/DeviceImages/Create",
"Microsoft.CloudPC/DeviceImages/Delete",
"Microsoft.CloudPC/DeviceImages/Read",
"Microsoft.CloudPC/OnPremisesConnections/Create",
"Microsoft.CloudPC/OnPremisesConnections/Delete",
"Microsoft.CloudPC/OnPremisesConnections/Read",
"Microsoft.CloudPC/OnPremisesConnections/Update",
"Microsoft.CloudPC/OnPremisesConnections/RunHealthChecks",
"Microsoft.CloudPC/OnPremisesConnections/UpdateAdDomainPassword",
"Microsoft.CloudPC/ProvisioningPolicies/Assign",
"Microsoft.CloudPC/ProvisioningPolicies/Create",
"Microsoft.CloudPC/ProvisioningPolicies/Delete",
"Microsoft.CloudPC/ProvisioningPolicies/Read",
"Microsoft.CloudPC/ProvisioningPolicies/Update",
"Microsoft.CloudPC/RoleAssignments/Create",
"Microsoft.CloudPC/RoleAssignments/Update",
"Microsoft.CloudPC/RoleAssignments/Delete",
"Microsoft.CloudPC/Roles/Read",
"Microsoft.CloudPC/SelfServiceSettings/Read",
"Microsoft.CloudPC/SelfServiceSettings/Update"
],
"condition": null
}
]
}
}
Feedback
Submit and view feedback for