Delen via

Software-inventaris-API weergeven

  • 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
  • ina.api.security.microsoft.com

API-beschrijving

Haalt de inventaris van de organisatiesoftware op.
Ondersteunt OData V4-query's.
Door OData ondersteunde operators:
$filter op: id, nameen vendor 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 Microsoft Defender voor Eindpunt-API's gebruiken voor meer informatie, waaronder het kiezen van machtigingen.

Machtigingstype Machtiging Weergavenaam van machtiging
Toepassing Software.Read.All 'Informatie over software voor het beheer van bedreigingen en beveiligingsproblemen lezen'
Gedelegeerd (werk- of schoolaccount) Software.Read 'Informatie over software voor het beheer van bedreigingen en beveiligingsproblemen lezen'

HTTP-aanvraag

GET /api/Software

Aanvraagheaders

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

Aanvraagtekst

Leeg

Antwoord

Als dit lukt, retourneert deze methode 200 OK met de software-inventarisatie in de hoofdtekst.

Voorbeeld

Voorbeeld van aanvraag

Hier volgt een voorbeeld van de aanvraag.

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

Antwoordvoorbeeld

Hier volgt een voorbeeld van het antwoord.

{
    "@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
            }
            ...
        ]
}

Tip

Wil je meer weten? Neem contact op met de Microsoft Security-community in onze Tech Community: Microsoft Defender for Endpoint Tech Community.