secureScore-RessourcentypsecureScore resource type

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Stellt das sichere Ergebnis eines Mandanten pro Tag mit Bewertungsdaten auf Mandanten-und Steuerelementebene dar.Represents a tenant's secure score per day of scoring data, at the tenant and control level. Standardmäßig werden 90 Tage Daten gespeichert.By default, 90 days of data is held. Diese Daten werden nach createdDateTimesortiert, von der neuesten bis zur frühesten.This data is sorted by createdDateTime, from latest to earliest. Auf diese Weise können Sie Seiten Antworten mit $Top = n verwenden, wobei n = die Anzahl der Daten Tage ist, die Sie abrufen möchten.This will allow you to page responses by using $top=n, where n = the number of days of data that you want to retrieve.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
List secureScoresList secureScores secureScoressecureScores Lesen von Eigenschaften und Metadaten eines secureScores-Objekts.Read properties and metadata of a secureScores object.

EigenschaftenProperties

Entitätstyp, der Eigenschaften des Mandanten Sicherheits Bewertungs Werts enthält (tägliche Momentaufnahme Daten).Entity type containing properties of the tenant security score (daily snapshot data).

EigenschaftProperty TypType BeschreibungDescription
azureTenantIdazureTenantId StringString GUID-Zeichenfolge für Mandanten-ID.GUID string for tenant ID.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Das Datum, an dem die Entität erstellt wird.The date when the entity is created.
idid ZeichenfolgeString Kombination von azureTenantId_createdDateTime.Combination of azureTenantId_createdDateTime.
licensedUserCountlicensedUserCount Int32Int32 Anzahl lizenzierter Benutzer des angegebenen Mandanten.Licensed user count of the given tenant.
activeUserCountactiveUserCount Int32Int32 Anzahl der aktiven Benutzer des angegebenen Mandanten.Active user count of the given tenant.
currentScorecurrentScore Gleitkommawert mit doppelter GenauigkeitDouble Mandanten-aktuell Erreichtes Ergebnis am angegebenen Datum.Tenant current attained score on specified date.
maxScoremaxScore Gleitkommawert mit doppelter GenauigkeitDouble Mandanten maximal mögliche Punktzahl am angegebenen Datum.Tenant maximum possible score on specified date.
enabledServicesenabledServices String collectionString collection Von Microsoft bereitgestellte Dienste für den Mandanten (beispielsweise Exchange Online, Skype, SharePoint).Microsoft-provided services for the tenant (for example, Exchange online, Skype, Sharepoint).
averageComparativeScoresaverageComparativeScores averageComparativeScore -SammlungaverageComparativeScore collection Durchschnittliche Punktzahl in unterschiedlichen Bereichen (beispielsweisedurch Schnitt nach Branche, Durchschnitt durch Bestuhlung) und Steuerelementkategorie (Identität, Daten, Gerät, apps, Infrastruktur) innerhalb des Bereichs.Average score by different scopes (for example, average by industry, average by seating) and control category (Identity, Data, Device, Apps, Infrastructure) within the scope.
controlScorescontrolScores controlScore -SammlungcontrolScore collection Enthält Mandanten Ergebnisse für eine Gruppe von Steuerelementen.Contains tenant scores for a set of controls.

BeziehungenRelationships

Keine.None.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.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"
}