secureScore resource type

Is this page helpful?

Any additional feedback?

Feedback will be sent to Microsoft: By pressing the submit button, your feedback will be used to improve Microsoft products and services. Privacy policy.

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 tenant's secure score per day of scoring data, at the tenant and control level. By default, 90 days of data is held. This data is sorted by createdDateTime, from latest to earliest. This will allow you to page responses by using $top=n, where n = the number of days of data that you want to retrieve.

Methods

Method	Return Type	Description
List secureScores	secureScores	Read properties and metadata of a secureScores object.

Properties

Entity type containing properties of the tenant security score (daily snapshot data).

Property	Type	Description
azureTenantId	String	GUID string for tenant ID.
createdDateTime	DateTimeOffset	The date when the entity is created.
id	String	Combination of azureTenantId_createdDateTime.
licensedUserCount	Int32	Licensed user count of the given tenant.
activeUserCount	Int32	Active user count of the given tenant.
currentScore	Double	Tenant current attained score on specified date.
maxScore	Double	Tenant maximum possible score on specified date.
enabledServices	String collection	Microsoft-provided services for the tenant (for example, Exchange online, Skype, Sharepoint).
averageComparativeScores	averageComparativeScore collection	Average score by different scopes (for example, average by industry, average by seating) and control category (Identity, Data, Device, Apps, Infrastructure) within the scope.
controlScores	controlScore collection	Contains tenant scores for a set of controls.

Relationships

None.

JSON representation

The following is a JSON representation of the resource.

{
  "id": "String",
  "azureTenantId": "Guid",
  "createdDate": "DateTimeOffset",
  "licensedUserCount": "Int32",
  "activeUserCount": "Int32",
  "currentScore": "Int32",
  "maxScore": "Int32",
  "averageScore": "Double",
  "enabledServices": "Collection(string)",
  "averageComparativeScores": "Collection(microsoft.graph.SecureScore.averageComparativeScores)",
  "controlScores": "Collection(microsoft.graph.SecureScore.controlScores)",
  "createdDateTime": "2019-02-07T20:33:53.156Z"
}