Reports.Read.All
Allows an app to read all service usage reports on behalf of the signed-in user. Services that provide usage reports include Office 365 and Azure Active Directory.
Graph Methods
Type: A = Application Permission, D = Delegate Permission
Delegate Permission
Id | 02e97553-ed7b-43d0-ab3c-f8bace0d040c |
Consent Type | Admin |
Display String | Read all usage reports |
Description | Allows an app to read all service usage reports on behalf of the signed-in user. Services that provide usage reports include Office 365 and Azure Active Directory. |
Application Permission
Id | 230c1aed-a721-4c5d-9cb4-a90514e508ef |
Display String | Read all usage reports |
Description | Allows an app to read all service usage reports without a signed-in user. Services that provide usage reports include Office 365 and Azure Active Directory. |
Resources
applicationSignInDetailedSummary
Property | Type | Description |
---|---|---|
aggregatedEventDateTime | DateTimeOffset | The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z . |
appDisplayName | String | Name of the application that the user signed in to. |
appId | String | ID of the application that the user signed in to. |
id | String | A unique ID representing the sign-in activity. Inherited from entity. |
signInCount | Int64 | Count of sign-ins made by the application. |
status | signInStatus | Details of the sign-in status. |
applicationSignInSummary
Property | Type | Description |
---|---|---|
appDisplayName | String | Name of the application that the user signed into. |
failedSignInCount | Int64 | Count of failed sign-ins made by the application. |
successPercentage | Int32 | Percentage of successful sign-ins made by the application. |
successfulSignInCount | Int64 | Count of successful sign-ins made by the application. |
archivedPrintJob
Property | Type | Description |
---|---|---|
acquiredByPrinter | Boolean | True if the job was acquired by a printer; false otherwise. Read-only. |
acquiredDateTime | DateTimeOffset | The dateTimeOffset when the job was acquired by the printer, if any. Read-only. |
completionDateTime | DateTimeOffset | The dateTimeOffset when the job was completed, canceled or aborted. Read-only. |
copiesPrinted | Int32 | The number of copies that were printed. Read-only. |
createdBy | userIdentity | The user who created the print job. Read-only. |
createdDateTime | DateTimeOffset | The dateTimeOffset when the job was created. Read-only. |
id | String | The archived print job's GUID. Read-only. |
printerId | String | The printer ID that the job was queued for. Read-only. |
processingState | printJobProcessingState | The print job's final processing state. Read-only. |
credentialUsageSummary
Property | Type | Description |
---|---|---|
authMethod | usageAuthMethod | Represents the authentication method that the user used. Possible values are:email , mobileSMS , mobileCall , officePhone , securityQuestion (only used for self-service password reset), appNotification , appCode , alternateMobileCall (supported only in registration), fido , appPassword , unknownFutureValue . |
failureActivityCount | Int64 | Provides the count of failed resets or registration data. |
feature | featureType | Defines the feature to report. Possible values are: registration , reset , unknownFutureValue . |
id | String | The unique identifier for the activity. Read-only. |
successfulActivityCount | Int64 | Provides the count of successful registrations or resets. |
credentialUserRegistrationCount
Property | Type | Description |
---|---|---|
id | String | The unique identifier for the activity. Read-only. |
totalUserCount | Int64 | Provides the total user count in the tenant. |
userRegistrationCounts | userRegistrationCount collection | A collection of registration count and status information for users in your tenant. |
credentialUserRegistrationDetails
Property | Type | Description |
---|---|---|
authMethods | registrationAuthMethod collection | Represents the authentication method that the user has registered. Possible values are: email , mobilePhone , officePhone , securityQuestion (only used for self-service password reset), appNotification , appCode , alternateMobilePhone (supported only in registration), fido , appPassword , unknownFutureValue . |
id | String | The unique identifier for the activity. Read-only. |
isCapable | Boolean | Indicates whether the user is ready to perform self-service password reset or MFA. |
isEnabled | Boolean | Indicates whether the user enabled to perform self-service password reset. |
isMfaRegistered | Boolean | Indicates whether the user is registered for MFA. |
isRegistered | Boolean | Indicates whether the user has registered any authentication methods for self-service password reset. |
userDisplayName | String | Provides the user name of the corresponding user. |
userPrincipalName | String | Provides the user principal name of the corresponding user. |
credentialUserRegistrationsSummary
Property | Type | Description |
---|---|---|
id | String | The unique identifier for this entity. Required. Read-only. |
lastRefreshedDateTime | DateTimeOffset | Date and time the entity was last updated in the multi-tenant management platform. Optional. Read-only. |
mfaAndSsprCapableUserCount | Int32 | The number of users that are capable of performing multi-factor authentication or self service password reset. Optional. Read-only. |
mfaConditionalAccessPolicyState | String | The state of a conditional access policy that enforces multi-factor authentication. Optional. Read-only. |
mfaExcludedUserCount | Int32 | The number of users in the multi-factor authentication exclusion security group (Microsoft 365 Lighthouse - MFA exclusions). Optional. Read-only. |
mfaRegisteredUserCount | Int32 | The number of users registered for multi-factor authentication. Optional. Read-only. |
securityDefaultsEnabled | Boolean | A flag indicating whether Identity Security Defaults is enabled. Optional. Read-only. |
ssprEnabledUserCount | Int32 | The number of users enabled for self service password reset. Optional. Read-only. |
ssprRegisteredUserCount | Int32 | The number of users registered for self service password reset. Optional. Read-only. |
tenantDisplayName | String | The display name for the managed tenant. Required. Read-only. |
tenantId | String | The Azure Active Directory tenant identifier for the managed tenant. Required. Read-only. |
totalUserCount | Int32 | The total number of users in the given managed tenant. Optional. Read-only. |
office365ActiveUserCounts
Property | Type | Description |
---|---|---|
reportRefreshDate | Date | The latest date of the content. |
office365 | Int64 | The number of active users in Microsoft 365. This number includes all the active users in Exchange, OneDrive, SharePoint, Skype For Business, Yammer, and Microsoft Teams. You can find the definition of active user for each product in the respective property description. |
exchange | Int64 | The number of active users in Exchange. Any user who can read and send email is considered an active user. |
oneDrive | Int64 | The number of active users in OneDrive. Any user who viewed or edited files, shared files internally or externally, or synced files is considered an active user. |
sharePoint | Int64 | The number of active users in SharePoint. Any user who viewed or edited files, shared files internally or externally, synced files, or viewed SharePoint pages is considered an active user. |
skypeForBusiness | Int64 | The number of active users in Skype For Business. Any user who organized or participated in conferences, or joined peer-to-peer sessions is considered an active user. |
yammer | Int64 | The number of active users in Yammer. Any user who can post, read, or like messages is considered an active user. |
teams | Int64 | The number of active users in Microsoft Teams. Any user who posted messages in team channels, sent messages in private chat sessions, or participated in meetings or calls is considered an active user. |
reportDate | Date | The date on which a number of users were active. |
reportPeriod | String | The number of days the report covers. |
office365ActiveUserDetail
Property | Type | Description |
---|---|---|
reportRefreshDate | Date | The latest date of the content. |
userPrincipalName | String | The user principal name (UPN) of the user. The UPN is an Internet-style login name for the user based on the Internet standard RFC 822. By convention, this should map to the user's email name. The general format is [email protected], where domain must be present in the tenant’s collection of verified domains. This property is required when a user is created. |
displayName | String | The name displayed in the address book for the user. This is usually the combination of the user's first name, middle initial, and last name. This property is required when a user is created and it cannot be cleared during updates. |
isDeleted | Boolean | Whether this user has been deleted or soft deleted. |
deletedDate | Date | The date when the delete operation happened. Default value is "null" when the user has not been deleted. |
hasExchangeLicense | Boolean | Whether the user has been assigned an Exchange license. |
hasOneDriveLicense | Boolean | Whether the user has been assigned a OneDrive license. |
hasSharePointLicense | Boolean | Whether the user has been assigned a SharePoint license. |
hasSkypeForBusinessLicense | Boolean | Whether the user has been assigned a Skype For Business license. |
hasYammerLicense | Boolean | Whether the user has been assigned a Yammer license. |
hasTeamsLicense | Boolean | Whether the user has been assigned a Teams license. |
exchangeLastActivityDate | Date | The date when user last read or sent email. |
oneDriveLastActivityDate | Date | The date when user last viewed or edited files, shared files internally or externally, or synced files. |
sharePointLastActivityDate | Date | The date when user last viewed or edited files, shared files internally or externally, synced files, or viewed SharePoint pages. |
skypeForBusinessLastActivityDate | Date | The date when user last organized or participated in conferences, or joined peer-to-peer sessions. |
yammerLastActivityDate | Date | The date when user last posted, read, or liked message. |
teamsLastActivityDate | Date | The date when user last posted messages in team channels, sent messages in private chat sessions, or participated in meetings or calls. |
exchangeLicenseAssignDate | Date | The last date when the user was assigned an Exchange license. |
oneDriveLicenseAssignDate | Date | The last date when the user was assigned a OneDrive license. |
sharePointLicenseAssignDate | Date | The last date when the user was assigned a SharePoint license. |
skypeForBusinessLicenseAssignDate | Date | The last date when the user was assigned a Skype For Business license. |
yammerLicenseAssignDate | Date | The last date when the user was assigned a Yammer license. |
teamsLicenseAssignDate | Date | The last date when the user was assigned a Teams license. |
assignedProducts | String collection | All the products assigned for the user. |
office365GroupsActivityCounts
Property | Type | Description |
---|---|---|
reportRefreshDate | Date | The latest date of the content. |
exchangeEmailsReceived | Int64 | The number of emails received by Group mailboxes. |
yammerMessagesPosted | Int64 | The number of messages posted to Yammer groups. |
yammerMessagesRead | Int64 | The number of messages read in Yammer groups. |
yammerMessagesLiked | Int64 | The number of messages liked in Yammer groups. |
reportDate | Date | The date on which a number of emails were sent to a group mailbox or a number of messages were posted, read, or liked in a Yammer group |
reportPeriod | String | The number of days the report covers. |
office365GroupsActivityDetail
Property | Type | Description |
---|---|---|
groupId | String | The group id. |
reportRefreshDate | Date | The latest date of the content. |
groupDisplayName | String | The display name of the group. |
isDeleted | Boolean | Whether this user has been deleted or soft deleted. |
ownerPrincipalName | String | The group owner principal name. |
lastActivityDate | Date | The last activity date for the following scenarios: group mailbox received email; user viewed, edited, shared, or synced files in SharePoint document library; user viewed SharePoint pages; user posted, read, or liked messages in Yammer groups. |
groupType | String | The group type. Possible values are: Public or Private. |
memberCount | Int64 | The group member count. |
externalMemberCount | Int64 | The group external member count. |
exchangeReceivedEmailCount | Int64 | The number of email that the group mailbox received. |
sharePointActiveFileCount | Int64 | The number of active files in SharePoint Group site. |
yammerPostedMessageCount | Int64 | The number of messages posted to Yammer groups. |
yammerReadMessageCount | Int64 | The number of messages read in Yammer groups. |
yammerLikedMessageCount | Int64 | The number of messages liked in Yammer groups. |
exchangeMailboxTotalItemCount | Int64 | The number of items in the group mailbox. |
exchangeMailboxStorageUsedInBytes | Int64 | The storage used of the group mailbox. |
sharePointTotalFileCount | Int64 | The total number of files in SharePoint Group site. |
sharePointSiteStorageUsedInBytes | Int64 | The storage used by SharePoint Group site. |
reportPeriod | String | The number of days the report covers. |
office365GroupsActivityFileCounts
Property | Type | Description |
---|---|---|
reportRefreshDate | Date | The latest date of the content. |
total | Int64 | The total number of files in the group's SharePoint document library. |
active | Int64 | The number of files that were viewed, edited, shared, or synced in the group's SharePoint document library. |
reportDate | Date | The date on which a number of files were active in the group's SharePoint site. |
reportPeriod | String | The number of days the report covers. |
office365GroupsActivityGroupCounts
Property | Type | Description |
---|---|---|
reportRefreshDate | Date | The latest date of the content. |
total | Int64 | The total number of groups. |
active | Int64 | The number of active groups. A group is considered active if any of the following occurred: group mailbox received email; user viewed, edited, shared, or synced files in SharePoint document library; user viewed SharePoint pages; user posted, read, or liked messages in Yammer groups. |
reportDate | Date | The date on which a number of groups were active. |
reportPeriod | String | The number of days the report covers. |
office365GroupsActivityStorage
Property | Type | Description |
---|---|---|
reportRefreshDate | Date | The latest date of the content. |
mailboxStorageUsedInBytes | Int64 | The storage used in group mailbox. |
siteStorageUsedInBytes | Int64 | The storage used in SharePoint document library. |
reportDate | Date | The snapshot date for Exchange and SharePoint used storage. |
reportPeriod | String | The number of days the report covers. |
office365ServicesUserCounts
Property | Type | Description |
---|---|---|
reportRefreshDate | Date | The latest date of the content. |
exchangeActive | Int64 | The number of active users on Exchange. Any user who can read and send email is considered an active user. |
exchangeInactive | Int64 | The number of inactive users on Exchange. |
oneDriveActive | Int64 | The number of active users on OneDrive. Any user who viewed or edited files, shared files internally or externally, or synced files is considered an active user. |
oneDriveInactive | Int64 | The number of inactive users on OneDrive. |
sharePointActive | Int64 | The number of active users on SharePoint. Any user who viewed or edited files, shared files internally or externally, synced files, or viewed SharePoint pages is considered an active user. |
sharePointInactive | Int64 | The number of inactive users on SharePoint. |
skypeForBusinessActive | Int64 | The number of active users on Skype For Business. Any user who organized or participated in conferences, or joined peer-to-peer sessions is considered an active user. |
skypeForBusinessInactive | Int64 | The number of inactive users on Skype For Business. |
yammerActive | Int64 | The number of active users on Yammer. Any user who can post, read, or like messages is considered an active user. |
yammerInactive | Int64 | The number of inactive users on Yammer. |
teamsActive | Int64 | The number of active users on Microsoft Teams. Any user who posted messages in team channels, sent messages in private chat sessions, or participated in meetings or calls is considered an active user. |
teamsInactive | Int64 | The number of inactive users on Microsoft Teams. |
office365Active | Int64 | The number of active users on Microsoft 365. |
office365Inactive | Int64 | The number of inactive users on Microsoft 365. |
reportPeriod | String | The number of days the report covers. |
printer
Property | Type | Description |
---|---|---|
capabilities | printerCapabilities | The capabilities of the printer associated with this printer share. Inherited from printerBase. |
defaults | printerDefaults | The printer's default print settings. Inherited from printerBase. |
displayName | String | The name of the printer. Inherited from printerBase. |
hasPhysicalDevice | Boolean | True if the printer has a physical device for printing. Read-only. |
id | String | The document's identifier. Inherited from printerBase. Read-only. |
isAcceptingJobs | Boolean | Whether the printer is currently accepting new print jobs. Inherited from printerBase. |
isShared | Boolean | True if the printer is shared; false otherwise. Read-only. |
lastSeenDateTime | DateTimeOffset | The most recent dateTimeOffset when a printer interacted with Universal Print. Read-only. |
location | printerLocation | The physical and/or organizational location of the printer. Inherited from printerBase. |
manufacturer | String | The manufacturer reported by the printer. Inherited from printerBase. |
model | String | The model name reported by the printer. Inherited from printerBase. |
registeredDateTime | DateTimeOffset | The DateTimeOffset when the printer was registered. Read-only. |
status | printerStatus | The processing status of the printer, including any errors. Inherited from printerBase. |
printUsageByPrinter
Property | Type | Description |
---|---|---|
completedBlackAndWhiteJobCount | Int64 | The number of black and white print jobs completed by the printer on the associated date. |
completedColorJobCount | Int64 | The number of color print jobs completed by the printer on the associated date. |
id | String | The ID of this usage summary. |
incompleteJobCount | Int64 | The number of print jobs that were queued for the printer, but not completed, on the associated date. |
printerID | String | The ID of the printer represented by these statistics. |
usageDate | Date | The date associated with these statistics. |
printUsageByUser
Property | Type | Description |
---|---|---|
completedBlackAndWhiteJobCount | Int64 | The number of black and white print jobs completed on behalf of the user on the associated date. |
completedColorJobCount | Int64 | The number of color print jobs completed on behalf of the user on the associated date. |
id | String | The ID of this usage summary. |
incompleteJobCount | Int64 | The number of print jobs that were queued on behalf of the user, but not completed, on the associated date. |
usageDate | Date | The date associated with these statistics. |
userPrincipalName | String | The UPN of the user represented by these statistics. |
relyingPartyDetailedSummary
Property | Type | Description |
---|---|---|
id | String | Read-only. Unique Identifier generated at API level. |
relyingPartyId | String | This identifier is used to identify the relying party to this Federation Service. It is used when issuing claims to the relying party. |
serviceId | String | Uniquely identifies the Active Directory forest. |
migrationStatus | migrationStatus | Indication of whether the application can be moved to Azure AD or require more investigation. Possible values are: ready , needsReview , additionalStepsRequired , unknownFutureValue . |
migrationValidationDetails | keyValuePair collection | Specifies all the validations check done on applications configuration details to evaluate if the application is ready to be moved to Azure AD. |
relyingPartyName | String | Name of application or other entity on the internet that uses an identity provider to authenticate a user who wants to log in. |
failedSignInCount | Int64 | Number of failed sign in on Active Directory Federation Service in the period specified. |
replyUrls | String collection | Specifies where the relying party expects to receive the token. |
signInSuccessRate | Double | Number of successful / (number of successful + number of failed sign ins) on Active Directory Federation Service in the period specified. |
successfulSignInCount | Int64 | Number of successful sign ins on Active Directory Federation Service. |
totalSignInCount | Int64 | Number of successful + failed sign ins failed sign ins on Active Directory Federation Service in the period specified. |
uniqueUserCount | Int64 | Number of unique users that have signed into the application. |
userCredentialUsageDetails
Property | Type | Description |
---|---|---|
authMethod | usageAuthMethod | Represents the authentication method that the user used. Possible values are:email , mobileSMS , mobileCall , officePhone , securityQuestion (only used for self-service password reset), appNotification , appCode , alternateMobileCall (supported only in registration), fido , appPassword ,unknownFutureValue |
eventDateTime | DateTimeOffset | The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z . |
failureReason | String | Provides the failure reason for the corresponding reset or registration workflow. |
feature | featureType | Possible values are: registration , reset , unknownFutureValue . |
id | String | Read-only. The unique identifier for the activity. Read-only. |
isSuccess | Boolean | Indicates success or failure of the workflow. |
userDisplayName | String | User name of the user performing the reset or registration workflow. |
userPrincipalName | String | User principal name of the user performing the reset or registration workflow. |