セキュリティ上の推奨事項を取得する

  • 適用対象: Microsoft Defender for Endpoint, Microsoft Defender for Endpoint Plan 1, Microsoft Defender Vulnerability Management

重要

この記事の一部の情報は、市販される前に大幅に変更される可能性があるプレリリース製品に関するものです。 Microsoft は、ここで提供されるいかなる情報に関して、明示または黙示を問わず、いかなる保証も行いません。

特定のデバイス ID に関連するセキュリティに関する推奨事項のコレクションを取得します。

アクセス許可

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

アクセス許可の種類 アクセス許可 アクセス許可の表示名
アプリケーション SecurityRecommendation.Read.All '脅威と脆弱性管理のセキュリティに関する推奨事項情報の読み取り'
委任 (職場または学校のアカウント) SecurityRecommendation.Read '脅威と脆弱性管理のセキュリティに関する推奨事項情報の読み取り'

HTTP 要求

GET /api/machines/{machineId}/recommendations

要求ヘッダー

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

要求本文

Empty

応答

成功した場合、このメソッドは本文のセキュリティに関する推奨事項を含む 200 OK を返します。

例

要求の例

以下は、要求の例です。

GET https://api.security.microsoft.com/api/machines/ac233fa6208e1579620bf44207c4006ed7cc4501/recommendations

応答の例

以下は、応答の例です。

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#Recommendations",
    "value": [
        {
            "id": "va-_-git-scm-_-git",
            "productName": "git",
            "recommendationName": "Update Git to version 2.24.1.2",
            "weaknesses": 3,
            "vendor": "git-scm",
            "recommendedVersion": "2.24.1.2",
            "recommendationCategory": "Application",
            "subCategory": "",
            "severityScore": 0,
            "publicExploit": false,
            "activeAlert": false,
            "associatedThreats": [],
            "remediationType": "Update",
            "status": "Active",
            "configScoreImpact": 0,
            "exposureImpact": 0,
            "totalMachineCount": 0,
            "exposedMachinesCount": 1,
            "nonProductivityImpactedAssets": 0,
            "relatedComponent": "Git"
        },
...
}
  • Last updated on