Updates from: 05/14/2022 01:13:10
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Chat List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-list.md
One of the following permissions is required to call this API. To learn more, in
|:--|:| |Delegated (work or school account) | Chat.ReadBasic, Chat.Read, Chat.ReadWrite | |Delegated (personal Microsoft account) | Not supported. |
-|Application | Not supported. |
+|Application | Chat.ReadBasic.All*, Chat.Read.All*, Chat.ReadWrite.All* |
+
+\* This scenario is only supported for the following call: `GET /users/{user-id | user-principal-name}/chats`
## HTTP request
v1.0 Chat Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chat-post.md
Namespace: microsoft.graph
Create a new [chat](../resources/chat.md) object.
+> **Note:** Only one one-on-one chat can exist between two members. If a one-on-one chat already exists, this operation will return the existing chat and not create a new one.
+ ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Device Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/device-update.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Directory.ReadWrite.All |
+|Delegated (work or school account) | Directory.AccessAsUser.All |
|Delegated (personal Microsoft account) | Not supported. | |Application | Device.ReadWrite.All, Directory.ReadWrite.All |
v1.0 Educationschool Delete Users https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/educationschool-delete-users.md
If successful, this method returns a `204 No Content` response code and an empty
## Example
-##### Request
+### Request
-Here is an example of the request.
+The following is an example of a request.
# [HTTP](#tab/http)
DELETE https://graph.microsoft.com/beta/education/schools/10001/users/13006
-##### Response
+### Response
The following is an example of the response.
v1.0 Governanceresource Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governanceresource-get.md
description: "Retrieve the properties and relationships of a governanceResource
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Get governanceResource
v1.0 Governanceresource List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governanceresource-list.md
description: "Retrieve a collection of governanceResource that the requestor has
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # List governanceResources
v1.0 Governanceresource Register https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governanceresource-register.md
description: "Register a governanceResource object in PIM."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # governanceResource: register
v1.0 Governanceroleassignment Export https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governanceroleassignment-export.md
description: "Retrieve a collection of governanceRoleAssignmentRequests in the f
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Export governanceRoleAssignmentRequests
v1.0 Governanceroleassignment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governanceroleassignment-get.md
description: "Retrieve the properties and relationships of a governanceRoleAssig
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Get governanceRoleAssignment
v1.0 Governanceroleassignment List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governanceroleassignment-list.md
description: "Retrieve a collection of governanceRoleAssignments."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # List governanceRoleAssignments
v1.0 Governanceroleassignmentrequest Cancel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governanceroleassignmentrequest-cancel.md
description: "Cancel a governanceRoleAssignmentRequest."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Cancel governanceRoleAssignmentRequest
v1.0 Governanceroleassignmentrequest Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governanceroleassignmentrequest-get.md
description: "Get a governanceRoleAssignmentRequest. "
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Get governanceRoleAssignmentRequest
v1.0 Governanceroleassignmentrequest List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governanceroleassignmentrequest-list.md
description: "Retrieve a collection of governanceRoleAssignmentRequests. "
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # List governanceRoleAssignmentRequests
v1.0 Governanceroleassignmentrequest Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governanceroleassignmentrequest-post.md
description: "Create a role assignment request to represent the operation you wa
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Create governanceRoleAssignmentRequest
v1.0 Governanceroleassignmentrequest Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governanceroleassignmentrequest-update.md
description: "Enable administrators to update their decisions (`AdminApproved` o
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Update governanceRoleAssignmentRequests
v1.0 Governanceroledefinition Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governanceroledefinition-get.md
description: "Retrieve the properties and relationships of a governanceRoleDefin
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Get governanceRoleDefinition
v1.0 Governanceroledefinition List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governanceroledefinition-list.md
description: "Get a collection of governanceRoleDefinitions on a resource."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # List governanceRoleDefinitions
v1.0 Governancerolesetting Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governancerolesetting-get.md
description: "Retrieve the properties and relationships of a governanceRoleSetti
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Get governanceRoleSetting
v1.0 Governancerolesetting List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governancerolesetting-list.md
description: "Retrieve a collection of governanceRoleSettings on a resource."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # List governanceRoleSettings
v1.0 Governancerolesetting Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/governancerolesetting-update.md
description: "Update the properties of governanceRoleSetting."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Update governanceRoleSetting
v1.0 Group List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-list.md
Title: "List groups"
-description: "List all the groups available in an organization, including but not limited to Microsoft 365 groups."
+description: "List all the groups available in an organization, excluding dynamic distribution groups."
ms.localizationpriority: high ms.prod: "groups"
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-List all the groups in an organization, including but not limited to Microsoft 365 groups.
+List all the groups available in an organization, excluding dynamic distribution groups. To retrieve dynamic distribution groups, [use the Exchange admin center](/exchange/recipients/dynamic-distribution-groups/dynamic-distribution-groups).
This operation returns by default only a subset of the more commonly used properties for each group. These _default_ properties are noted in the [Properties](../resources/group.md#properties) section. To get properties that are _not_ returned by default, do a [GET operation](group-get.md) for the group and specify the properties in a `$select` OData query option. The **hasMembersWithLicenseErrors** property is an exception and is not returned in the `$select` query.
v1.0 Group Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-post-members.md
Add a member to a security or Microsoft 365 group through the **members** naviga
The following table shows the types of members that can be added to either security groups or Microsoft 365 groups.
-| Object type | Member of security groups | Member of Microsoft 365 group |
-|-|-|-|
-| Users | ![Can be group member][Yes] | ![Can be group member][Yes] |
-| Security groups | ![Can be group member][Yes] | ![Cannot be group member][No] |
-| Microsoft 365 groups | ![Cannot be group member][No] | ![Cannot be group member][No] |
-| devices | ![Can be group member][Yes] | ![Cannot be group member][No] |
-| service principals | ![Can be group member][Yes] | ![Cannot be group member][No] |
+| Object type | Member of security groups | Member of Microsoft 365 group |
+|-|-|-|
+| Users | ![Can be group member][Yes] | ![Can be group member][Yes] |
+| Security groups | ![Can be group member][Yes] | ![Cannot be group member][No] |
+| Microsoft 365 groups | ![Cannot be group member][No] | ![Cannot be group member][No] |
+| Devices | ![Can be group member][Yes] | ![Cannot be group member][No] |
+| Service principals | ![Can be group member][Yes] | ![Cannot be group member][No] |
+| Organizational contacts | ![Can be group member][Yes] | ![Cannot be group member][No] |
## Permissions
v1.0 Managedtenants Managedtenant List Tenantusage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/managedtenants-managedtenant-list-tenantusage.md
+
+ Title: "List tenantUsage"
+description: "Get a list of the tenantUsage objects and their properties."
+
+ms.localizationpriority: medium
++
+# List tenantUsage
+Namespace: microsoft.graph.managedTenants
++
+Gets the [monthly usage data for each service](../resources/managedtenants-tenantusage.md) in a [managed tenant](../resources/managedtenants-managedtenant.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|ManagedTenants.Read.All, ManagedTenants.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /tenantRelationships/managedTenants/tenantUsage
+```
+
+## Optional query parameters
+This method supports the `$filter` and `$top` [OData query parameters](/graph/query-parameters) to help customize the response.
+
+## 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 a collection of [tenantUsage](../resources/managedtenants-tenantusage.md) objects in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "list_tenantusage"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/tenantRelationships/managedTenants/tenantUsage
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.managedTenants.tenantUsage)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "tenantId": "fab47685-ce50-424c-5215-ae28419c9db6",
+ "reportingDate": "2021-09-01T00:00:00Z",
+ "monthlyActiveUsers": 100,
+ "serviceUsages": [
+ { "serviceName": "Excel", "monthlyActiveUsers": 100 },
+ { "serviceName": "Exchange", "monthlyActiveUsers": 100 },
+ { "serviceName": "Intune", "monthlyActiveUsers": 100 },
+ { "serviceName": "Teams", "monthlyActiveUsers": 100 },
+ { "serviceName": "Word", "monthlyActiveUsers": 100 }
+ ]
+ }
+ ]
+}
+```
v1.0 Policyroot List Rolemanagementpolicies https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/policyroot-list-rolemanagementpolicies.md
Title: "List roleManagementPolicies" description: "Get the unifiedRoleManagementPolicy resources from the roleManagementPolicies navigation property."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Policyroot List Rolemanagementpolicyassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/policyroot-list-rolemanagementpolicyassignments.md
Title: "List roleManagementPolicyAssignments" description: "Get the unifiedRoleManagementPolicyAssignment resources from the roleManagementPolicyAssignments navigation property."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Privilegedapproval Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedapproval-get.md
description: "Retrieve the properties and relationships of privilegedapproval ob
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Get privilegedApproval
v1.0 Privilegedapproval List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedapproval-list.md
description: "Retrieve a list of privilegedapproval objects."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # List privilegedApproval
v1.0 Privilegedapproval Myrequests https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedapproval-myrequests.md
description: "Get the requestor's approval requests."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # privilegedApproval: myRequests
v1.0 Privilegedapproval Post Privilegedapproval https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedapproval-post-privilegedapproval.md
description: "Use this API to create a new privilegedApproval."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Create privilegedApproval
v1.0 Privilegedapproval Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedapproval-update.md
description: "Update the properties of privilegedapproval object."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Update privilegedapproval
v1.0 Privilegedoperationevent List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedoperationevent-list.md
description: "Retrieve audit events generated by PIM for role operations."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # List privilegedOperationEvents
v1.0 Privilegedrole Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedrole-get.md
description: "Retrieve the properties and relationships of privilegedRole object
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Get privilegedRole
v1.0 Privilegedrole List Assignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedrole-list-assignments.md
description: "Retrieve a list of privilegedRoleAssignment objects that are assoc
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # List assignments
v1.0 Privilegedrole List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedrole-list.md
description: "Retrieve a list of privilegedRole objects."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # List privilegedRoles
v1.0 Privilegedrole Selfactivate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedrole-selfactivate.md
description: "Activate the role that is assigned to the requester."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # privilegedRole: selfActivate
v1.0 Privilegedrole Selfdeactivate https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedrole-selfdeactivate.md
description: "Deactivate the role that is assigned to the requestor."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # privilegedRole: selfDeactivate
v1.0 Privilegedroleassignment Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedroleassignment-delete.md
description: "Delete privilegedRoleAssignment."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Delete privilegedRoleAssignment
v1.0 Privilegedroleassignment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedroleassignment-get.md
description: "Retrieve the properties and relationships of privilegedRoleAssignm
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Get privilegedRoleAssignment
v1.0 Privilegedroleassignment List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedroleassignment-list.md
description: "Retrieve a list of privilegedRoleAssignment objects, which corresp
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # List privilegedRoleAssignments
v1.0 Privilegedroleassignment Makeeligible https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedroleassignment-makeeligible.md
description: "Make the role assignment eligible."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # privilegedRoleAssignment: makeEligible
v1.0 Privilegedroleassignment Makepermanent https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedroleassignment-makepermanent.md
description: "Make the role assignment permanent."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # privilegedRoleAssignment: makePermanent
v1.0 Privilegedroleassignment My https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedroleassignment-my.md
description: "Get the requestor's privileged role assignments."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # privilegedRoleAssignment: my
v1.0 Privilegedroleassignment Post Privilegedroleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedroleassignment-post-privilegedroleassignments.md
description: "Use this API to create a new privilegedRoleAssignment."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Create privilegedRoleAssignment
v1.0 Privilegedroleassignmentrequest Cancel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedroleassignmentrequest-cancel.md
description: "Cancel a privilegedRoleAssignmentRequest."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Cancel privilegedRoleAssignmentRequest
v1.0 Privilegedroleassignmentrequest List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedroleassignmentrequest-list.md
description: "Retrieve a collection of privilegedRoleAssignmentRequest. "
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # List privilegedRoleAssignmentRequests
v1.0 Privilegedroleassignmentrequest My https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedroleassignmentrequest-my.md
description: "Get the requester's privileged role assignment requests."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # privilegedRoleAssignmentRequest: my
v1.0 Privilegedroleassignmentrequest Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedroleassignmentrequest-post.md
description: "Create a privilegedroleassignmentrequest object."
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Create privilegedRoleAssignmentRequest
v1.0 Privilegedrolesettings Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedrolesettings-get.md
description: "Retrieve the role settings for the given role. A privilegedRoleSet
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Get privilegedRoleSettings
v1.0 Privilegedrolesettings Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedrolesettings-update.md
description: "Update the role settings for the given role setting. A privilegedR
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Update privilegedRoleSettings
v1.0 Privilegedrolesummary Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/privilegedrolesummary-get.md
description: "Retrieve the properties and relationships of privilegedRoleSummary
ms.localizationpriority: medium doc_type: apiPageType ms.prod: "governance"-+ # Get privilegedRoleSummary
v1.0 Rbacapplication Rolescheduleinstances https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/rbacapplication-rolescheduleinstances.md
Title: "rbacApplication: roleScheduleInstances" description: "Retrieve both roleAssignmentScheduleInstances and roleEligibilityScheduleInstances."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Rbacapplication Roleschedules https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/rbacapplication-roleschedules.md
Title: "rbacApplication: roleSchedules" description: "Retrieve both roleAssignmentSchedules and roleEligibilitySchedules."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleassignmentschedule Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleassignmentschedule-filterbycurrentuser.md
Title: "unifiedRoleAssignmentSchedule: filterByCurrentUser" description: "Get a list of the unifiedRoleAssignmentSchedule objects and their properties filtered by a particular user principal"-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleassignmentschedule Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleassignmentschedule-get.md
Title: "Get unifiedRoleAssignmentSchedule" description: "Read the properties and relationships of an unifiedRoleAssignmentSchedule object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleassignmentschedule List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleassignmentschedule-list.md
Title: "List unifiedRoleAssignmentSchedules" description: "Get a list of the unifiedRoleAssignmentSchedule objects and their properties."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleassignmentscheduleinstance Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleassignmentscheduleinstance-filterbycurrentuser.md
Title: "unifiedRoleAssignmentScheduleInstance: filterByCurrentUser" description: "Get a list of the unifiedRoleAssignmentScheduleInstance objects and their properties filtered by a particular user principal"-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleassignmentscheduleinstance Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleassignmentscheduleinstance-get.md
Title: "Get unifiedRoleAssignmentScheduleInstance" description: "Read the properties and relationships of an unifiedRoleAssignmentScheduleInstance object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleassignmentscheduleinstance List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleassignmentscheduleinstance-list.md
Title: "List unifiedRoleAssignmentScheduleInstances" description: "Get a list of the unifiedRoleAssignmentScheduleInstance objects and their properties."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleassignmentschedulerequest Cancel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleassignmentschedulerequest-cancel.md
Title: "unifiedRoleAssignmentScheduleRequest: cancel" description: "Cancel a unifiedRoleAssignmentScheduleRequest."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleassignmentschedulerequest Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleassignmentschedulerequest-filterbycurrentuser.md
Title: "unifiedRoleAssignmentScheduleRequest: filterByCurrentUser" description: "Get a list of the unifiedRoleAssignmentScheduleRequest objects and their properties filtered by a particular user principal"-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleassignmentschedulerequest Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleassignmentschedulerequest-get.md
Title: "Get unifiedRoleAssignmentScheduleRequest" description: "Read the properties and relationships of an unifiedRoleAssignmentScheduleRequest object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleassignmentschedulerequest List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleassignmentschedulerequest-list.md
Title: "List unifiedRoleAssignmentScheduleRequests" description: "Get a list of the unifiedRoleAssignmentScheduleRequest objects and their properties."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleassignmentschedulerequest Post Unifiedroleassignmentschedulerequests https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleassignmentschedulerequest-post-unifiedroleassignmentschedulerequests.md
Title: "Create unifiedRoleAssignmentScheduleRequest" description: "Create a new unifiedRoleAssignmentScheduleRequest object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleeligibilityschedule Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleeligibilityschedule-filterbycurrentuser.md
Title: "unifiedRoleEligibilitySchedule: filterByCurrentUser" description: "Get a list of the unifiedRoleEligibilitySchedule objects and their properties filtered by a particular user principal"-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleeligibilityschedule Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleeligibilityschedule-get.md
Title: "Get unifiedRoleEligibilitySchedule" description: "Read the properties and relationships of an unifiedRoleEligibilitySchedule object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleeligibilityschedule List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleeligibilityschedule-list.md
Title: "List unifiedRoleEligibilitySchedules" description: "Get a list of the unifiedRoleEligibilitySchedule objects and their properties."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleeligibilityscheduleinstance Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleeligibilityscheduleinstance-filterbycurrentuser.md
Title: "unifiedRoleEligibilityScheduleInstance: filterByCurrentUser" description: "Get a list of the unifiedRoleEligibilityScheduleInstance objects and their properties filtered by a particular user principal"-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleeligibilityscheduleinstance Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleeligibilityscheduleinstance-get.md
Title: "Get unifiedRoleEligibilityScheduleInstance" description: "Read the properties and relationships of an unifiedRoleEligibilityScheduleInstance object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleeligibilityscheduleinstance List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleeligibilityscheduleinstance-list.md
Title: "List unifiedRoleEligibilityScheduleInstances" description: "Get a list of the unifiedRoleEligibilityScheduleInstance objects and their properties."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleeligibilityschedulerequest Cancel https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleeligibilityschedulerequest-cancel.md
Title: "unifiedRoleEligibilityScheduleRequest: cancel" description: "Cancel a unifiedRoleEligibilityScheduleRequest."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleeligibilityschedulerequest Filterbycurrentuser https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleeligibilityschedulerequest-filterbycurrentuser.md
Title: "unifiedRoleEligibilityScheduleRequest: filterByCurrentUser" description: "Get a list of the unifiedRoleEligibilityScheduleRequest objects and their properties filtered by a particular user principal"-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleeligibilityschedulerequest Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleeligibilityschedulerequest-get.md
Title: "Get unifiedRoleEligibilityScheduleRequest" description: "Read the properties and relationships of an unifiedRoleEligibilityScheduleRequest object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleeligibilityschedulerequest List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleeligibilityschedulerequest-list.md
Title: "List unifiedRoleEligibilityScheduleRequests" description: "Get a list of the unifiedRoleEligibilityScheduleRequest objects and their properties."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedroleeligibilityschedulerequest Post Unifiedroleeligibilityschedulerequests https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedroleeligibilityschedulerequest-post-unifiedroleeligibilityschedulerequests.md
Title: "Create unifiedRoleEligibilityScheduleRequest" description: "Create a new unifiedRoleEligibilityScheduleRequest object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedrolemanagementpolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedrolemanagementpolicy-get.md
Title: "Get unifiedRoleManagementPolicy" description: "Read the properties and relationships of an unifiedRoleManagementPolicy object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedrolemanagementpolicy List Effectiverules https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedrolemanagementpolicy-list-effectiverules.md
Title: "List effectiveRules" description: "Get the unifiedRoleManagementPolicyRule resources from the effectiveRules navigation property."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedrolemanagementpolicy List Rules https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedrolemanagementpolicy-list-rules.md
Title: "List rules" description: "Get the unifiedRoleManagementPolicyRule resources from the rules navigation property."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedrolemanagementpolicy List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedrolemanagementpolicy-list.md
Title: "List unifiedRoleManagementPolicies" description: "Get a list of the unifiedRoleManagementPolicy objects and their properties."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedrolemanagementpolicyassignment Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedrolemanagementpolicyassignment-get.md
Title: "Get unifiedRoleManagementPolicyAssignment" description: "Read the properties and relationships of an unifiedRoleManagementPolicyAssignment object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedrolemanagementpolicyassignment List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedrolemanagementpolicyassignment-list.md
Title: "List unifiedRoleManagementPolicyAssignments" description: "Get a list of the unifiedRoleManagementPolicyAssignment objects and their properties."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedrolemanagementpolicyrule Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedrolemanagementpolicyrule-get.md
Title: "Get unifiedRoleManagementPolicyRule" description: "Read the properties and relationships of an unifiedRoleManagementPolicyRule object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedrolemanagementpolicyrule List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedrolemanagementpolicyrule-list.md
Title: "List unifiedRoleManagementPolicyRules" description: "Get a list of the unifiedRoleManagementPolicyRule objects and their properties."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Unifiedrolemanagementpolicyrule Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/unifiedrolemanagementpolicyrule-update.md
Title: "Update unifiedRoleManagementPolicyRule" description: "Update a rule defined for a role management policy."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: apiPageType
v1.0 Eventmessagedetail https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/eventmessagedetail.md
List of events supported
| Event | Description | | :- | :- |
-| [callEndedEventMessageDetail](../resources/callStartedEventMessageDetail.md) | A call has ended. |
+| [callEndedEventMessageDetail](../resources/callEndedEventMessageDetail.md) | A call has ended. |
| [callRecordingEventMessageDetail](../resources/callRecordingEventMessageDetail.md) | Call recording is available. | | [callStartedEventMessageDetail](../resources/callStartedEventMessageDetail.md) | A call has started. | | [callTranscriptEventMessageDetail](../resources/callTranscriptEventMessageDetail.md) | Call transcript is available. |
v1.0 Governancepermission https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/governancepermission.md
description: "Represents the access permission that a governanceSubject has to a
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "governance"-+ # governancePermission resource type
v1.0 Governanceresource https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/governanceresource.md
description: "Represents resources that could be managed by Privileged Identity
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "governance"-+ # governanceResource resource type
v1.0 Governanceroleassignment https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/governanceroleassignment.md
description: "Represents the assignment of a user or group to a role."
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "governance"-+ # governanceRoleAssignment resource type
v1.0 Governanceroleassignmentrequest https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/governanceroleassignmentrequest.md
description: "Represents the request for role assignment operations in Priviledg
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "governance"-+ # governanceRoleAssignmentRequest resource type
v1.0 Governanceroledefinition https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/governanceroledefinition.md
description: "Represents the role definitions. For Azure resources, it can repre
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "governance"-+ # governanceRoleDefinition resource type
v1.0 Governancerolesetting https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/governancerolesetting.md
description: "Represents a set of configurations on each role definition that ne
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "governance"-+ # governanceRoleSetting resource type
v1.0 Governancerulesetting https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/governancerulesetting.md
description: "Represents the rules that the role settings are composed of."
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "governance"-+ # governanceRuleSetting resource type
v1.0 Governanceschedule https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/governanceschedule.md
description: "Represents the schedule for a governanceRoleAssignmentRequest. For
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "governance"-+ # governanceSchedule resource type
v1.0 Governancesubject https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/governancesubject.md
description: "Represents users, groups, and service principals being managed in
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "governance"-+ # governanceSubject resource type
v1.0 Managedtenants Managedtenant https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-managedtenant.md
None.
|tenantsCustomizedInformation|[microsoft.graph.managedTenants.tenantCustomizedInformation](../resources/managedtenants-tenantcustomizedinformation.md) collection|The collection of tenant level customized information across managed tenants.| |tenantsDetailedInformation|[microsoft.graph.managedTenants.tenantDetailedInformation](../resources/managedtenants-tenantdetailedinformation.md) collection|The collection tenant level detailed information across managed tenants.| |tenantTags|[microsoft.graph.managedTenants.tenantTag](../resources/managedtenants-tenanttag.md) collection|The collection of tenant tags across managed tenants.|
+|tenantUsage|[microsoft.graph.managedTenants.tenantUsage](../resources/managedtenants-tenantusage.md) collection|The collection of tenant usage across managed tenants.|
|windowsDeviceMalwareStates|[microsoft.graph.managedTenants.windowsDeviceMalwareState](../resources/managedtenants-windowsdevicemalwarestate.md) collection|The state of malware for Windows devices, registered with Microsoft Endpoint Manager, across managed tenants.| |windowsProtectionStates|[microsoft.graph.managedTenants.windowsProtectionState](../resources/managedtenants-windowsprotectionstate.md) collection|The protection state for Windows devices, registered with Microsoft Endpoint Manager, across managed tenants.|
v1.0 Managedtenants Serviceusage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-serviceusage.md
+
+ Title: "serviceUsage resource type"
+description: "Represents monthly active usage data for a service in a managed tenant."
+
+ms.localizationpriority: medium
++
+# serviceUsage resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents monthly active usage data for a service in a managed tenant.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|monthlyActiveUsers|Int32|Number of monthly active users of the service. Required. Read-only.|
+|serviceName|String|The name for the Microsoft 365 service that generated the usage. Required. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "@odata.type": "microsoft.graph.managedTenants.serviceUsage"
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.serviceUsage",
+ "serviceName": "String",
+ "monthlyActiveUsers": "Integer"
+}
+```
+
v1.0 Managedtenants Tenantusage https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/managedtenants-tenantusage.md
+
+ Title: "tenantUsage resource type"
+description: "Represents the number of monthly active users per service in a managed tenant for the previous month. The time period for the data is a sliding window that takes a snapshot once a day."
+
+ms.localizationpriority: medium
++
+# tenantUsage resource type
+
+Namespace: microsoft.graph.managedTenants
++
+Represents the number of monthly active users per service in a managed tenant for the previous month. The time period for the data is a sliding window that takes a snapshot once a day.
++
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List tenantUsage](../api/managedtenants-managedtenant-list-tenantusage.md)|[microsoft.graph.managedTenants.tenantUsage](../resources/managedtenants-tenantusage.md) collection|Gets the [monthly usage data for each service](../resources/managedtenants-tenantusage.md) in a [managed tenant](../resources/managedtenants-managedtenant.md).|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|The unique identifier for the tenant. Required. Read-only.|
+|reportDateTime|DateTimeOffset|The day the report was generated for the previous month. Required. Read-only.|
+|serviceUsages|[microsoft.graph.managedTenants.serviceUsage](../resources/managedtenants-serviceusage.md) collection|The number of monthly active users for each service in the tenant. Example
+|tenantId|String|The Azure Active Directory tenant identifier for the [managed tenant](../resources/managedtenants-tenant.md). Read-only.|
+|totalActiveUsers|Int32|The total number of unique, active users. Required. Read-only.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.managedTenants.tenantUsage",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.managedTenants.tenantUsage",
+ "id": "String (identifier)",
+ "serviceUsages": [
+ {
+ "@odata.type": "microsoft.graph.managedTenants.serviceUsage"
+ }
+ ],
+ "tenantId": "String",
+ "reportDateTime": "String (timestamp)",
+ "totalActiveUsers": "Integer"
+}
+```
v1.0 Policyroot https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/policyroot.md
Title: "policyRoot resource type" description: "Resource type exposing navigation properties for the policies singleton."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Privilegedaccess https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/privilegedaccess.md
description: " for example, `privilegedAccess/azureResources` represents PIM man
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "governance"-+ # privilegedAccess resource type
v1.0 Privilegedapproval https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/privilegedapproval.md
description: "Represents an approval that is requested in Privileged Identity Ma
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "governance"-+ # privilegedApproval resource type (deprecated)
v1.0 Privilegedidentitymanagement Directory https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/privilegedidentitymanagement-directory.md
Title: "Privileged Identity Management - Azure AD" description: "APIs for Azure AD Privileged Identity Management to manage Azure Active Directory roles." ms.localizationpriority: high-+ ms.prod: "governance" doc_type: conceptualPageType
v1.0 Privilegedidentitymanagement Resources https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/privilegedidentitymanagement-resources.md
Title: "Privileged Identity Management - Azure resources" description: "APIs for Azure AD Privileged Identity Management to manage Azure resources." ms.localizationpriority: high-+ ms.prod: "governance" doc_type: conceptualPageType
v1.0 Privilegedidentitymanagement Root https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/privilegedidentitymanagement-root.md
description: "APIs for Azure AD Privileged Identity Management to manage Azure A
ms.localizationpriority: high doc_type: conceptualPageType ms.prod: "governance"-+ # Privileged Identity Management (deprecated)
v1.0 Privilegedoperationevent https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/privilegedoperationevent.md
description: "Represents an audit event that is generated by Privileged Identity
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "governance"-+ # privilegedOperationEvent resource type (deprecated)
v1.0 Privilegedrole https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/privilegedrole.md
description: "Represents an Azure AD administrator role, such as: Global Adminis
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "governance"-+ # privilegedRole resource type (deprecated)
v1.0 Privilegedroleassignment https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/privilegedroleassignment.md
description: "Represents a privileged role assignment for a particular user. "
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "governance"-+ # privilegedRoleAssignment resource type (deprecated)
v1.0 Privilegedroleassignmentrequest https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/privilegedroleassignmentrequest.md
description: "Represents the request for role assignment operations in Privilegd
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "governance"-+ # privilegedRoleAssignmentRequest resource type (deprecated)
v1.0 Privilegedrolesettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/privilegedrolesettings.md
description: "Represents the settings for a privileged role."
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "governance"-+ # privilegedRoleSettings resource type
v1.0 Privilegedrolesummary https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/privilegedrolesummary.md
description: "The statistics summary for a particular role."
ms.localizationpriority: medium doc_type: resourcePageType ms.prod: "governance"-+ # privilegedRoleSummary resource type
v1.0 Request https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/request.md
Title: "request resource type" description: "An abstract entity type to model the asynchronized request workflow to create, update, and delete an object."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Ticketinfo https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/ticketinfo.md
Title: "ticketInfo resource type" description: "The object that represents ticket information related to role assignment requests"-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Unifiedroleassignmentschedule https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/unifiedroleassignmentschedule.md
Title: "unifiedRoleAssignmentSchedule resource type" description: "Represents a schedule for an active role assignment operations through Azure AD Privileged Identity Management."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Unifiedroleassignmentscheduleinstance https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/unifiedroleassignmentscheduleinstance.md
Title: "unifiedRoleAssignmentScheduleInstance resource type" description: "Represents a schedule instance for an active role assignment operations through Azure AD Privileged Identity Management."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Unifiedroleassignmentschedulerequest https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/unifiedroleassignmentschedulerequest.md
Title: "unifiedRoleAssignmentScheduleRequest resource type" description: "Represents the request for active role assignment operations through Azure AD Privileged Identity Management."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Unifiedroleeligibilityschedule https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/unifiedroleeligibilityschedule.md
Title: "unifiedRoleEligibilitySchedule resource type" description: "Represents a schedule for an eligible role assignment operations through Azure AD Privileged Identity Management."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Unifiedroleeligibilityscheduleinstance https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/unifiedroleeligibilityscheduleinstance.md
Title: "unifiedRoleEligibilityScheduleInstance resource type" description: "Represents a schedule instance for an eligible role assignment operations through Azure AD Privileged Identity Management."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Unifiedroleeligibilityschedulerequest https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/unifiedroleeligibilityschedulerequest.md
Title: "unifiedRoleEligibilityScheduleRequest resource type" description: "Represents the request for eligible role assignment operations through Azure AD Privileged Identity Management."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Unifiedrolemanagementpolicy https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/unifiedrolemanagementpolicy.md
Title: "unifiedRoleManagementPolicy resource type" description: "A unifiedRoleManagementPolicy specifies the various policies associated with a scope and role definition. It is derived from microsoft.graph.policyBase."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Unifiedrolemanagementpolicyapprovalrule https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/unifiedrolemanagementpolicyapprovalrule.md
Title: "unifiedRoleManagementPolicyApprovalRule resource type" description: "A unifiedRoleManagementPolicyApprovalRule specifies the approval rule associated with a role management policy. It is derived from microsoft.graph.unifiedRoleManagementPolicyRule."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Unifiedrolemanagementpolicyassignment https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/unifiedrolemanagementpolicyassignment.md
Title: "unifiedRoleManagementPolicyAssignment resource type" description: "A unifiedRoleManagementPolicyAssignment assigns the policy to a specific scope and role definition."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Unifiedrolemanagementpolicyauthenticationcontextrule https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/unifiedrolemanagementpolicyauthenticationcontextrule.md
Title: "unifiedRoleManagementPolicyAuthenticationContextRule resource type" description: "A unifiedRoleManagementPolicyAuthenticationContextRule specifies the enablement rule associated with a role management policy. It is derived from microsoft.graph.unifiedRoleManagementPolicyRule."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Unifiedrolemanagementpolicyenablementrule https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/unifiedrolemanagementpolicyenablementrule.md
Title: "unifiedRoleManagementPolicyEnablementRule resource type" description: "A unifiedRoleManagementPolicyEnablementRule specifies the enablement rule associated with a role management policy. It is derived from microsoft.graph.unifiedRoleManagementPolicyRule."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Unifiedrolemanagementpolicyexpirationrule https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/unifiedrolemanagementpolicyexpirationrule.md
Title: "unifiedRoleManagementPolicyExpirationRule resource type" description: "A unifiedRoleManagementPolicyExpirationRule specifies the enablement rule associated with a role management policy. It is derived from microsoft.graph.unifiedRoleManagementPolicyRule."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Unifiedrolemanagementpolicynotificationrule https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/unifiedrolemanagementpolicynotificationrule.md
Title: "unifiedRoleManagementPolicyNotificationRule resource type" description: "A unifiedRoleManagementPolicyNotificationRule specifies the notification rule associated with a role management policy. It is derived from microsoft.graph.unifiedRoleManagementPolicyRule."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Unifiedrolemanagementpolicyrule https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/unifiedrolemanagementpolicyrule.md
Title: "unifiedRoleManagementPolicyRule resource type" description: "A unifiedRoleManagementPolicyRule specifies the rule associated with a role management policy. It is abstract."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Unifiedrolemanagementpolicyruletarget https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/unifiedrolemanagementpolicyruletarget.md
Title: "unifiedRoleManagementPolicyRuleTarget resource type" description: "A unifiedRoleManagementPolicyRuleTarget specifies the target associated with the role management policy."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Unifiedroleschedulebase https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/unifiedroleschedulebase.md
Title: "unifiedRoleScheduleBase resource type" description: "Base property of unified role schedules that combines unified role assignment schedules and unified role eligibility schedules"-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Unifiedrolescheduleinstancebase https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/unifiedrolescheduleinstancebase.md
Title: "unifiedRoleScheduleInstanceBase resource type" description: "Base property of unified role schedule instance that combines unified role assignment schedule instance and unified role eligibility schedule instance"-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType
v1.0 Chat Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/chat-post.md
Namespace: microsoft.graph
Create a new [chat](../resources/chat.md) object.
+> **Note:** Only one one-on-one chat can exist between two members. If a one-on-one chat already exists, this operation will return the existing chat and not create a new one.
+>
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Device Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/device-update.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | Directory.ReadWrite.All |
+|Delegated (work or school account) | Directory.AccessAsUser.All |
|Delegated (personal Microsoft account) | Not supported. | |Application | Device.ReadWrite.All, Directory.ReadWrite.All |
v1.0 Educationschool Delete Users https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/educationschool-delete-users.md
Do not supply a request body for this method.
If successful, this method returns a `204 No Content` response code and an empty response body. ## Example
-##### Request
-Here is an example of the request.
+### Request
+The following is an example of a request.
# [HTTP](#tab/http) <!-- {
DELETE https://graph.microsoft.com/v1.0/education/schools/{school-id}/users/{use
-##### Response
+### Response
The following is an example of the response. <!-- { "blockType": "response"
v1.0 Group List https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/group-list.md
Title: "List groups"
-description: "List all the groups available in an organization, including but not limited to Microsoft 365 groups."
+description: "List all the groups available in an organization, excluding dynamic distribution groups."
ms.localizationpriority: high ms.prod: "groups"
doc_type: apiPageType
Namespace: microsoft.graph
-List all the groups in an organization, including but not limited to Microsoft 365 groups.
+List all the groups available in an organization, excluding dynamic distribution groups. To retrieve dynamic distribution groups, [use the Exchange admin center](/exchange/recipients/dynamic-distribution-groups/dynamic-distribution-groups).
This operation returns by default only a subset of the properties for each group. These default properties are noted in the [Properties](../resources/group.md#properties) section. To get properties that are _not_ returned by default, do a [GET](group-get.md) operation for the group and specify the properties in a `$select` OData query option. The **hasMembersWithLicenseErrors** property is an exception and is not returned in the `$select` query.
v1.0 Group Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/group-post-members.md
Namespace: microsoft.graph
Add a member to a security or Microsoft 365 group through the **members** navigation property.
-You can add users, organizational contacts, service principals or other groups.
+The following table shows the types of members that can be added to either security groups or Microsoft 365 groups.
-> [!IMPORTANT]
->
-> - You can add members to security and Microsoft 365 groups only. For more information, see [Group types in Azure AD and Microsoft Graph only](/graph/api/resources/groups-overview#group-types-in-azure-ad-and-microsoft-graph).
-> - You cannot add security groups to Microsoft 365 groups.
-> - You cannot add Microsoft 365 groups to security groups or other Microsoft 365 groups.
-> - A security group can have users, devices, groups, or service principals as its members, while a Microsoft 365 group can have only users as its members.
+| Object type | Member of security groups | Member of Microsoft 365 group |
+|-|-|-|
+| Users | ![Can be group member][Yes] | ![Can be group member][Yes] |
+| Security groups | ![Can be group member][Yes] | ![Cannot be group member][No] |
+| Microsoft 365 groups | ![Cannot be group member][No] | ![Cannot be group member][No] |
+| Devices | ![Can be group member][Yes] | ![Cannot be group member][No] |
+| Service principals | ![Can be group member][Yes] | ![Cannot be group member][No] |
+| Organizational contacts | ![Can be group member][Yes] | ![Cannot be group member][No] |
## Permissions
HTTP/1.1 204 No Content
- [Update member's role in team](team-update-members.md) - [Remove member from team](team-delete-members.md) ++
+[Yes]: /graph/images/yesandnosymbols/greencheck.svg
+[No]: /graph/images/yesandnosymbols/no.svg
+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!-- {
HTTP/1.1 204 No Content
"section": "documentation", "tocPath": "", "suppressions": [
+ "Error: /api/group-post-members.md:
+ Failed to parse enumeration values for type microsoft.graph.add. Table requires a column header named one of the following: Member, Name, Value"
] }-->
v1.0 Eventmessagedetail https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/eventmessagedetail.md
List of events supported
| Event | Description | | :- | :- |
-| [callEndedEventMessageDetail](../resources/callStartedEventMessageDetail.md) | A call has ended. |
+| [callEndedEventMessageDetail](../resources/callEndedEventMessageDetail.md) | A call has ended. |
| [callRecordingEventMessageDetail](../resources/callRecordingEventMessageDetail.md) | Call recording is available. | | [callStartedEventMessageDetail](../resources/callStartedEventMessageDetail.md) | A call has started. | | [callTranscriptEventMessageDetail](../resources/callTranscriptEventMessageDetail.md) | Call transcript is available. |
v1.0 Policyroot https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/policyroot.md
Title: "policyRoot resource type" description: "Resource type exposing navigation properties for the policies singleton."-+ ms.localizationpriority: medium ms.prod: "governance" doc_type: resourcePageType