デバイスのセキュア スコアを取得するGet device secure score

適用対象:Applies to:

適用対象: Microsoft Defender for EndpointApplies to: Microsoft Defender for Endpoint

注意

米国政府機関のお客様の場合は、Microsoft Defender for Endpoint for US Government のお客様に記載されている URI を使用してくださいIf you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

ヒント

パフォーマンスを向上するために、地理的な場所に近いサーバーを使用できます。For better performance, you can use server closer to your geo location:

  • api-us.securitycenter.microsoft.comapi-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.comapi-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.comapi-uk.securitycenter.microsoft.com

デバイスの Microsoft Secure Score を取得しますRetrieves your Microsoft Secure Score for Devices. デバイスの Microsoft セキュア スコアが高いということは、エンドポイントがサイバー セキュリティの脅威攻撃に対してより回復力があることを意味します。A higher Microsoft Secure Score for Devices means your endpoints are more resilient from cybersecurity threat attacks.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。One of the following permissions is required to call this API. アクセス許可の選択方法など、詳細については 、「Use Microsoft Defender for Endpoint API」 を参照してください。To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

アクセス許可の種類Permission type アクセス許可Permission アクセス許可の表示名Permission display name
アプリケーションApplication Score.Read.AlllScore.Read.Alll 'Read Threat and Vulnerability Management score''Read Threat and Vulnerability Management score'
委任 (職場または学校のアカウント)Delegated (work or school account) Score.ReadScore.Read 'Read Threat and Vulnerability Management score''Read Threat and Vulnerability Management score'

HTTP 要求HTTP request

GET /api/configurationScore

要求ヘッダーRequest headers

名前Name Type 説明Description
AuthorizationAuthorization StringString ベアラー {token}。Bearer {token}. 必須Required.

要求本文Request body

EmptyEmpty

応答Response

成功した場合、このメソッドは 200 OK を返し、デバイスのセキュリティで保護されたスコア データを応答本文に返します。If successful, this method returns 200 OK, with the device secure score data in the response body.

Example

要求Request

以下は、要求の例です。Here is an example of the request.

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

応答Response

以下は、応答の例です。Here is an example of the response.

注意

ここに示す応答リストは、簡単に切り詰められることがあります。The response list shown here may be truncated for brevity.

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

関連項目See also