Auflisten der Softwareinventur-API

  • Gilt für:: Microsoft Defender for Endpoint, Microsoft Defender for Endpoint Plan 1

API-Beschreibung

Ruft die organization Softwareinventur ab.

Unterstützt OData V4-Abfragen. OData-unterstützte Operatoren:

  • $filter für die folgenden Eigenschaften:
    • id
    • name
    • vendor
  • $top mit einem maximalen Wert von 10.000.
  • $skip

Beispiele finden Sie unter OData-Abfragen mit Microsoft Defender for Endpoint.

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 for Endpoint-APIs.

Berechtigungstyp Permission Anzeigename der Berechtigung
Application Software.Read.All Informationen zur Bedrohungs- und Sicherheitsrisikomanagementsoftware lesen
Delegiert (Geschäfts-, Schul- oder Unikonto) Software.Read Informationen zur Bedrohungs- und Sicherheitsrisikomanagementsoftware lesen

HTTP-Anforderung

GET /api/Software

Anforderungsheader

Name Typ Beschreibung
Authorization Zeichenfolge Bearer {token}. Erforderlich.

Anforderungstext

Empty

Antwort

Bei erfolgreicher Ausführung gibt die Methode 200 OK mit dem Softwarebestand im Text zurück.

Beispiel

Anforderungsbeispiel

Nachfolgend sehen Sie ein Beispiel der Anforderung.

GET https://api.security.microsoft.com/api/Software

Anforderungsbeispiel

Hier ist ein Beispiel für die Antwort.

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#Software",
    "value": [
            {
                "id": "microsoft-_-edge",
                "name": "edge",
                "vendor": "microsoft",
                "weaknesses": 467,
                "publicExploit": true,
                "activeAlert": false,
                "exposedMachines": 172,
                "impactScore": 2.39947438
            }
            ...
        ]
}
  • Last updated on