Lista API för programvaruinventering

  • Gäller för: Microsoft Defender for Endpoint, Microsoft Defender for Endpoint Plan 1

API-beskrivning

Hämtar organisationens programvaruinventering.

Stöder OData V4-frågor. Operatorer som stöds av OData:

  • $filter på följande egenskaper:
    • id
    • name
    • vendor
  • $top med maxvärdet 10 000.
  • $skip

Se exempel på OData-frågor med Microsoft Defender för Endpoint.

Behörigheter

En av följande behörigheter krävs för att anropa det här API:et. Mer information om hur du väljer behörigheter finns i Använda Microsoft Defender för Endpoint-API:er.

Behörighetstyp Behörighet Visningsnamn för behörighet
Program Software.Read.All "Läs information om programvara för hot- och sårbarhetshantering"
Delegerat (arbets- eller skolkonto) Software.Read "Läs information om programvara för hot- och sårbarhetshantering"

HTTP-begäran

GET /api/Software

Frågerubriker

Namn Typ Beskrivning
Behörighet Sträng Ägaren {token}. Krävs.

Frågebrödtext

Tom

Svar

Om det lyckas returnerar den här metoden 200 OK med programvaruinventeringen i brödtexten.

Exempel

Exempel på begäran

Här är ett exempel på begäran.

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

Svarsexempel

Här är ett exempel 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
            }
            ...
        ]
}
  • Last updated on