insightSummary resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a daily or monthly summary of all usage insights on apps registered in your tenant that is configured for Microsoft Entra External ID for customers. A user (in activeUsers) can be counted more that once if they use multiple device platforms.

This resource represents a summary of the insights. For a breakdown of each insight, see the following resources and their associated APIs:

Inherits from entity.

Methods

Method Return type Description
List daily insightSummary collection Get a list of daily insightSummary objects on apps registered in your tenant configured for Microsoft Entra External ID for customers.
List monthly insightSummary collection Get a list of monthly insightSummary objects on apps registered in your tenant configured for Microsoft Entra External ID for customers.

Properties

Property Type Description
activeUsers Int64 Daily active users.
appId String The ID of the Microsoft Entra application.
authenticationCompletions Int64 Daily authentication completions.
authenticationRequests Int64 Daily authentication requests.
factDate Date The date of the insight.
id String Identifier for the insight. Inherited from entity.
os String The platform for the device that the customers used. Supports $filter (eq).
securityTextCompletions Int64 Daily MFA SMS completions.
securityTextRequests Int64 Daily MFA SMS requests.
securityVoiceCompletions Int64 Daily MFA Voice completions.
securityVoiceRequests Int64 Daily MFA Voice requests.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.insightSummary",
  "activeUsers": "Int64",
  "appId": "String",
  "authenticationCompletions": "Int64",
  "authenticationRequests": "Int64",
  "factDate": "String (date)",
  "id": "String (identifier)",
  "os": "String",
  "securityTextCompletions": "Int64",
  "securityTextRequests": "Int64",
  "securityVoiceCompletions": "Int64",
  "securityVoiceRequests": "Int64"
}