Sdílet prostřednictvím

Výpis rozhraní API inventáře softwaru

  • Článek

Platí pro:

Chcete vyzkoušet Defender pro Endpoint? Zaregistrujte se a získejte bezplatnou zkušební verzi,

Poznámka

Pokud jste zákazníkem státní správy USA, použijte identifikátory URI uvedené v programu Microsoft Defender for Endpoint pro zákazníky státní správy USA.

Tip

Pro lepší výkon můžete použít server blíže k vašemu geografickému umístění:

  • 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

Popis rozhraní API

Načte inventář softwaru organizace.
Podporuje dotazy OData V4.
Podporované operátory OData:
$filter ve vlastnostech : id, namea vendor .
$top s maximální hodnotou 10 000.
$skip.
Příklady najdete v tématu Dotazy OData pomocí Microsoft Defenderu for Endpoint.

Oprávnění

K volání tohoto rozhraní API se vyžaduje jedno z následujících oprávnění. Další informace, včetně toho, jak zvolit oprávnění, najdete v tématu Použití rozhraní MICROSOFT Defender for Endpoint API .

Typ oprávnění Povolení Zobrazovaný název oprávnění
Application Software.Read.All Přečtěte si informace o softwaru pro správu hrozeb a ohrožení zabezpečení.
Delegovaný (pracovní nebo školní účet) Software.Read Přečtěte si informace o softwaru pro správu hrozeb a ohrožení zabezpečení.

Požadavek HTTP

GET /api/Software

Hlavičky požadavků

Name (Název) Typ Popis
Oprávnění String Nosný {token}. Povinné.

Text požadavku

Prázdný

Odpověď

Pokud je tato metoda úspěšná, vrátí 200 OK s inventářem softwaru v těle.

Příklad

Příklad požadavku

Tady je příklad požadavku.

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

Příklad odpovědi

Tady je příklad odpovědi.

{
    "@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

Chcete se dozvědět více? Spojte se s komunitou zabezpečení Microsoftu v naší technické komunitě: Technická komunita Microsoft Defenderu for Endpoint.