secureScore リソースの種類secureScore resource type

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported.

テナントとコントロールレベルでのスコアデータの1日あたりのテナントのセキュリティスコアを表します。Represents a tenant's secure score per day of scoring data, at the tenant and control level. 既定では、90日間のデータが保持されます。By default, 90 days of data is held. このデータは、新しい日付から最も古い日付までの日付で並べ替えられます。This data is sorted by createdDateTime, from latest to earliest. これにより、$top = n (n は取得するデータの日数) を使用して、応答をページに表示できます。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
secureScores のリストList secureScores secureScoressecureScores 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
azureTenantIdazureTenantId StringString テナント ID の GUID 文字列。GUID string for tenant ID.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset エンティティが作成された日付。The date when the entity is created.
idid 文字列String AzureTenantId_createdDateTime の組み合わせ。Combination of azureTenantId_createdDateTime.
licensedUserCountlicensedUserCount Int32Int32 指定したテナントのライセンスされたユーザーカウント。Licensed user count of the given tenant.
activeUserCountactiveUserCount Int32Int32 指定したテナントのアクティブなユーザー数。Active user count of the given tenant.
currentScorecurrentScore 2 行分Double 指定された日付における現在のテナントのスコア。Tenant current attained score on specified date.
maxScoremaxScore 2 行分Double 指定した日付の有効なテナントの最大スコア。Tenant maximum possible score on specified date.
enabledServicesenabledServices 文字列コレクションString collection テナントの Microsoft 提供のサービス (Exchange online、Skype、Sharepoint など)。Microsoft-provided services for the tenant (for example, Exchange online, Skype, Sharepoint).
averageComparativeScoresaverageComparativeScores averageComparativeScoreコレクションaverageComparativeScore collection 範囲内の別のスコープ (たとえば、業種別平均、座席の平均)、コントロールカテゴリ (Id、データ、デバイス、アプリ、インフラストラクチャ) の平均スコア。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コレクションcontrolScore collection 一連のコントロールのテナントスコアを含みます。Contains tenant scores for a set of controls.

リレーションシップRelationships

なし。None.

JSON 表記JSON representation

リソースの JSON 表記を次に示します。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"
}