Empfehlung nach ID abrufen
Gilt für:
Möchten Sie Microsoft Defender für Endpunkt ausprobieren? Registrieren Sie sich für eine kostenlose Testversion.
Hinweis
Wenn Sie ein US Government-Kunde sind, verwenden Sie die URIs, die unter Microsoft Defender für Endpunkt für US Government-Kunden aufgeführt sind.
Tipp
Um die Leistung zu verbessern, können Sie den Server näher an Ihrem geografischen Standort verwenden:
- 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
Wichtig
Einige Informationen in diesem Artikel beziehen sich auf ein vorab veröffentlichtes Produkt, das vor der kommerziellen Veröffentlichung möglicherweise erheblich geändert wird. Microsoft übernimmt in Bezug auf die hier bereitgestellten Informationen keine Gewährleistung, weder ausdrücklich noch konkludent.
Ruft eine Sicherheitsempfehlung anhand ihrer ID ab.
Berechtigungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, einschließlich der Auswahl von Berechtigungen, finden Sie unter Verwenden von Microsoft Defender für Endpunkt-APIs .
Berechtigungstyp | Berechtigung | Anzeigename der Berechtigung |
---|---|---|
App | SecurityRecommendation.Read.All | Informationen zur Sicherheitsempfehlung für bedrohungs- und sicherheitsrelevantes Management lesen |
Delegiert (Geschäfts-, Schul- oder Unikonto) | SecurityRecommendation.Read | Informationen zur Sicherheitsempfehlung für bedrohungs- und sicherheitsrelevantes Management lesen |
HTTP-Anforderung
GET /api/recommendations/{id}
Anforderungsheader
Name | Typ | Beschreibung |
---|---|---|
Authorization | Zeichenfolge | Bearer {token}. Erforderlich. |
Anforderungstext
Empty
Antwort
Wenn die Methode erfolgreich verläuft, wird 200 OK mit den Sicherheitsempfehlungen im Text zurückgegeben.
Beispiel
Anforderungsbeispiel
Hier sehen Sie ein Beispiel für die Anforderung.
GET https://api.securitycenter.microsoft.com/api/recommendations/va-_-google-_-chrome
Anforderungsbeispiel
Hier ist ein Beispiel für die Antwort.
{
"@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",
"tags": [
"internetFacing"
],
"exposedCriticalDevices": 116
}
Verwandte Themen
- Microsoft Defender Sicherheitsrisikomanagement
- Sicherheitsempfehlung für die Defender-Sicherheitsrisikomanagement
Tipp
Möchten Sie mehr erfahren? Wenden Sie sich an die Microsoft-Sicherheitscommunity in unserer Tech Community: Microsoft Defender for Endpoint Tech Community.