Aanbevelingen per id ophalenGet recommendation by ID

Van toepassing op: Microsoft Defender voor EindpuntApplies to: Microsoft Defender for Endpoint

Notitie

Als u een klant van de Amerikaanse overheid bent, gebruikt u de URL's die worden vermeld in Microsoft Defender voor Eindpunt voor klanten van de Amerikaanse overheid.If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

Tip

Voor betere prestaties kunt u de server dichter bij uw geografische locatie gebruiken: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

Belangrijk

Sommige informatie is gerelateerd aan voorlopige productversies die mogelijk aanzienlijk gewijzigd worden voordat ze commercieel gepubliceerd worden.Some information relates to prereleased product which may be substantially modified before it's commercially released. Microsoft geeft geen garantie, uitdrukkelijk of impliciet, met betrekking tot de informatie die hier wordt beschreven.Microsoft makes no warranties, express or implied, with respect to the information provided here.

Hiermee wordt een beveiligingsaanbeveling opgehaald op de id.Retrieves a security recommendation by its ID.

MachtigingenPermissions

Een van de volgende machtigingen is vereist om deze API te bellen.One of the following permissions is required to call this API. Zie Microsoft Defender voor eindpunt-API's gebruiken voor meer informatie, inclusief het kiezen van machtigingen.To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

MachtigingstypePermission type MachtigingPermission Weergavenaam machtigingPermission display name
ToepassingApplication SecurityRecommendation.Read.AllSecurityRecommendation.Read.All 'Informatie over beveiligingsaanbeveling bedreigings- en kwetsbaarheidsbeheer lezen''Read Threat and Vulnerability Management security recommendation information'
Gedelegeerd (werk- of schoolaccount)Delegated (work or school account) SecurityRecommendation.ReadSecurityRecommendation.Read 'Informatie over beveiligingsaanbeveling bedreigings- en kwetsbaarheidsbeheer lezen''Read Threat and Vulnerability Management security recommendation information'

HTTP-aanvraagHTTP request

GET /api/recommendations/{id}

Kopteksten aanvragenRequest headers

NaamName TypeType BeschrijvingDescription
AutorisatieAuthorization TekenreeksString Bearer {token}.Bearer {token}. Vereist.Required.

Body aanvragenRequest body

LeegEmpty

AntwoordResponse

Als dit is gelukt, retourneert deze methode 200 OK met de beveiligingsaanbevelingen in de body.If successful, this method returns 200 OK with the security recommendations in the body.

VoorbeeldExample

AanvraagRequest

Hier is een voorbeeld van de aanvraag.Here is an example of the request.

GET https://api.securitycenter.microsoft.com/api/recommendations/va-_-google-_-chrome

AntwoordResponse

Hier is een voorbeeld van het antwoord.Here is an example of the response.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Recommendations/$entity",
    "id": "va-_-google-_-chrome",
    "productName": "chrome",
    "recommendationName": "Update Chrome",
    "weaknesses": 38,
    "vendor": "google",
    "recommendedVersion": "",
    "recommendationCategory": "Application",
    "subCategory": "",
    "severityScore": 0,
    "publicExploit": false,
    "activeAlert": false,
    "associatedThreats": [],
    "remediationType": "Update",
    "status": "Active",
    "configScoreImpact": 0,
    "exposureImpact": 3.9441860465116285,
    "totalMachineCount": 6,
    "exposedMachinesCount": 5,
    "nonProductivityImpactedAssets": 0,
    "relatedComponent": "Chrome"
}