Liste over softwareoversigts-API'en

API-beskrivelse

Henter organisationens softwarelager.

Understøtter OData V4-forespørgsler. OData-understøttede operatorer:

• $filter på følgende egenskaber:
  • id
  • name
  • vendor
• $top med en maksimumværdi på 10.000.
• $skip

Se eksempler på OData-forespørgsler med Microsoft Defender for Endpoint.

Tilladelser

En af følgende tilladelser er påkrævet for at kalde denne API. Hvis du vil vide mere, herunder hvordan du vælger tilladelser, skal du se Brug Microsoft Defender for Endpoint API'er for at få flere oplysninger.

Tilladelsestype	Tilladelse	Vist navn for tilladelse
Program	Software.Read.All	"Læs oplysninger om software til trussels- og sårbarhedsstyring"
Uddelegeret (arbejds- eller skolekonto)	Software.Read	"Læs oplysninger om software til trussels- og sårbarhedsstyring"

HTTP-anmodning

GET /api/Software

Anmodningsheadere

Navn	Type	Beskrivelse
Tilladelse	String	Ihændehaver {token}. Påkrævet.

Brødtekst i anmodning

Tom

Svar

Hvis det lykkes, returnerer denne metode 200 OK med softwarelageret i brødteksten.

Eksempel

Eksempel på anmodning

Her er et eksempel på anmodningen.

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

Svareksempel

Her er et eksempel på svaret.

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