Del via

Liste over softwareoversigts-API'en

  • Artikel

Gælder for:

Vil du opleve Microsoft Defender for Endpoint? Tilmeld dig en gratis prøveversion.

Bemærk!

Hvis du er us government-kunde, skal du bruge de URI'er, der er angivet i Microsoft Defender for Endpoint for us Government-kunder.

Tip

For at opnå en bedre ydeevne kan du bruge serveren tættere på din geografiske placering:

  • 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

API-beskrivelse

Henter organisationens softwarelager.
Understøtter OData V4-forespørgsler.
OData-understøttede operatorer:
$filter on: id, nameog vendor egenskaber.
$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
            }
            ...
        ]
}

Tip

Vil du vide mere? Engage med Microsoft Security-community'et i vores tech-community: Microsoft Defender for Endpoint Tech Community.