Edit

Share via

tenantUsage resource type

  • Article

Namespace: microsoft.graph.managedTenants

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 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 microsoft.graph.managedTenants.tenantUsage collection Gets the monthly usage data for each service in a managed tenant.

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 collection The number of monthly active users for each service in the tenant. Example services: Excel, Exchange, Intune, Outlook, Teams, Word. Required. Read-only.
tenantId String The Microsoft Entra tenant identifier for the managed tenant. Read-only.
totalActiveUsers Int32 The total number of unique, active users. Required. Read-only.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.managedTenants.tenantUsage",
  "id": "String (identifier)",
  "serviceUsages": [
    {
      "@odata.type": "microsoft.graph.managedTenants.serviceUsage"
    }
  ],
  "tenantId": "String",
  "reportDateTime": "String (timestamp)",
  "totalActiveUsers": "Integer"
}