Liste over programvarebeholdnings-API

API-beskrivelse

Henter programvarebeholdningen for organisasjonen.

Støtter OData V4-spørringer. OData-støttede operatorer:

• $filter på følgende egenskaper:
  • id
  • name
  • vendor
• $top med maksimumsverdien 10 000.
• $skip

Se eksempler på OData-spørringer med Microsoft Defender for endepunkt.

Tillatelser

Én av følgende tillatelser er nødvendig for å kalle opp denne API-en. Hvis du vil ha mer informasjon, inkludert hvordan du velger tillatelser, kan du se Bruke Microsoft Defender for endepunkt API-er for mer informasjon.

Tillatelsestype	Tillatelse	Visningsnavn for tillatelse
Program	Software.Read.All	Les informasjon om programvare for trussel- og sårbarhetsbehandling
Delegert (jobb- eller skolekonto)	Software.Read	Les informasjon om programvare for trussel- og sårbarhetsbehandling

HTTP-forespørsel

GET /api/Software

Forespørselshoder

Navn	Type:	Beskrivelse
Authorization	Streng	Bærer {token}. Obligatorisk.

Forespørselstekst

Tom

Svar

Hvis vellykket, returnerer denne metoden 200 OK med programvarebeholdningen i brødteksten.

Eksempel

Eksempel på forespørsel

Her er et eksempel på forespørselen.

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

Eksempel på svar

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
            }
            ...
        ]
}