secureScores resource type
- 2 minutes to read
-
Contributors
Important: APIs under the /beta version in Microsoft Graph are in preview and are subject to change. Use of these APIs in production applications is not supported.
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)",
}