次の方法で共有

デバイスのセキュア スコアを取得する

  • [アーティクル]

適用対象:

Microsoft Defender ATP を試してみたいですか? 無料試用版にサインアップしてください。

注:

米国政府機関のお客様は、 Microsoft Defender for Endpoint for US Government のお客様に記載されている URI を使用してください。

ヒント

パフォーマンスを向上させるために、地理的な場所に近いサーバーを使用できます。

  • us.api.security.microsoft.com
  • eu.api.security.microsoft.com
  • uk.api.security.microsoft.com
  • au.api.security.microsoft.com
  • swa.api.security.microsoft.com
  • ina.api.security.microsoft.com

デバイスの Microsoft セキュリティ スコアを取得します。 デバイスの Microsoft セキュア スコアが高いということは、エンドポイントがサイバー セキュリティの脅威攻撃に対してより回復力があることを意味します。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法など、詳細については、「エンドポイント API に Microsoft Defender を使用する」を参照してください。

アクセス許可の種類 アクセス許可 アクセス許可の表示名
アプリケーション Score.Read.All '脅威と脆弱性の管理スコアの読み取り'
委任 (職場または学校のアカウント) Score.Read '脅威と脆弱性の管理スコアの読み取り'

HTTP 要求

GET /api/configurationScore

要求ヘッダー

名前 型 説明
Authorization String ベアラー {token}。 必須。

要求本文

Empty

応答

成功した場合、このメソッドは 200 OK を返し、応答本文にはデバイスのセキュリティ スコア データが含まれます。

例

要求の例

以下は、要求の例です。

GET https://api.securitycenter.microsoft.com/api/configurationScore

応答の例

以下は、応答の例です。

注:

ここで示す応答リストは、簡潔にするために切り捨てられる場合があります。

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#ConfigurationScore/$entity",
    "time": "2019-12-03T09:15:58.1665846Z",
    "score": 340
}

関連項目

ヒント

さらに多くの情報を得るには、 Tech Community 内の Microsoft Security コミュニティ (Microsoft Defender for Endpoint Tech Community) にご参加ください。