Lijst van alle aanbevelingen

  • Artikel

Van toepassing op:

Wilt u Microsoft Defender voor Eindpunt ervaren? Meld u aan voor een gratis proefversie.

Opmerking

Als u een klant van de Amerikaanse overheid bent, gebruikt u de URI's die worden vermeld in Microsoft Defender voor Eindpunt voor klanten van de Amerikaanse overheid.

Tip

Voor betere prestaties kunt u de server dichter bij uw geografische locatie gebruiken:

  • 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

Belangrijk

Sommige informatie in dit artikel heeft betrekking op een vooraf uitgebracht product dat aanzienlijk kan worden gewijzigd voordat het commercieel wordt uitgebracht. Microsoft geeft geen garanties, expliciet of impliciet, met betrekking tot de informatie die hier wordt verstrekt.

Hiermee wordt een lijst opgehaald met alle beveiligingsaanbevelingen die van invloed zijn op de organisatie.

API-beschrijving

Retourneert informatie over alle beveiligingsaanbevelingen die van invloed zijn op de organisatie.

URL: GET:/api/recommendations
Ondersteunt OData V4-query's.
Door OData ondersteunde operators:
$filterop: id, productName, vendor, , recommendedVersion, subCategoryrecommendationCategory, , remediationTypeseverityScore, recommendedProgram, recommendedVendor, en status eigenschappen.
$top met een maximale waarde van 10.000.
$skip.
Zie voorbeelden bij OData-query's met Microsoft Defender voor Eindpunt.

Machtigingen

Een van de volgende machtigingen is vereist om deze API aan te roepen. Zie Use Microsoft Defender voor Eindpunt API's (Api's voor Microsoft Defender voor Eindpunt gebruiken) voor meer informatie, waaronder het kiezen van machtigingen.

Machtigingstype Machtiging Weergavenaam van machtiging
Toepassing SecurityRecommendation.Read.All 'Informatie over beveiligingsaanbieding voor bedreigings- en beveiligingsbeheer lezen'
Gedelegeerd (werk- of schoolaccount) SecurityRecommendation.Read 'Informatie over beveiligingsaanbieding voor bedreigings- en beveiligingsbeheer lezen'

HTTP-aanvraag

GET /api/recommendations

Aanvraagheaders

Naam Type Beschrijving
Vergunning Tekenreeks Bearer {token}. Vereist.

Aanvraagtekst

Lege

Antwoord

Als dit lukt, retourneert deze methode 200 OK met de lijst met beveiligingsaanbevelingen in de hoofdtekst.

Voorbeeld

Verzoek

Hier volgt een voorbeeld van de aanvraag.

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

Antwoord

Hier volgt een voorbeeld van het antwoord.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Recommendations",
    "value": [
        {
            "id": "va-_-microsoft-_-windows_10" "va-_-microsoft-_-windows_11",
            "productName": "windows_10" "Windows_11",
            "recommendationName": "Update Windows 10" "Update Windows 11",
            "weaknesses": 397,
            "vendor": "microsoft",
            "recommendedVersion": "",
            "recommendationCategory": "Application",
            "subCategory": "",
            "severityScore": 0,
            "publicExploit": true,
            "activeAlert": false,
            "associatedThreats": [
                "3098b8ef-23b1-46b3-aed4-499e1928f9ed",
                "40c189d5-0330-4654-a816-e48c2b7f9c4b",
                "4b0c9702-9b6c-4ca2-9d02-1556869f56f8",
                "e8fc2121-3cf3-4dd2-9ea0-87d7e1d2b29d",
                "94b6e94b-0c1d-4817-ac06-c3b8639be3ab"
            ],
            "remediationType": "Update",
            "status": "Active",
            "configScoreImpact": 0,
            "exposureImpact": 7.674418604651163,
            "totalMachineCount": 37,
            "exposedMachinesCount": 7,
            "nonProductivityImpactedAssets": 0,
            "relatedComponent": "Windows 10" "Windows 11"
        }
        ...
     ]
}

Zie ook

Tip

Wil je meer weten? Engage met de Microsoft Security-community in onze Tech Community: Microsoft Defender voor Eindpunt Tech Community.