Sdílet prostřednictvím


Získání bezpečnostního skóre zařízení

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

Načte vaše skóre zabezpečení microsoftu pro zařízení. Vyšší skóre zabezpečení microsoftu pro zařízení znamená, že vaše koncové body jsou odolnější proti útokům z kybernetické bezpečnosti.

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 Score.Read.All Read Threat and Vulnerability Management Score (Přečíst skóre správy hrozeb a ohrožení zabezpečení)
Delegovaný (pracovní nebo školní účet) Score.Read Read Threat and Vulnerability Management Score (Přečíst skóre správy hrozeb a ohrožení zabezpečení)

Požadavek HTTP

GET /api/configurationScore

Hlavičky požadavků

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

Text požadavku

Prázdný

Odpověď

V případě úspěchu vrátí tato metoda hodnotu 200 OK s daty skóre zabezpečení zařízení v těle odpovědi.

Příklad

Příklad požadavku

Tady je příklad požadavku.

GET https://api.securitycenter.microsoft.com/api/configurationScore

Příklad odpovědi

Tady je příklad odpovědi.

Poznámka

Tady uvedený seznam odpovědí může být kvůli stručnosti zkrácen.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#ConfigurationScore/$entity",
    "time": "2019-12-03T09:15:58.1665846Z",
    "score": 340
}

Viz také

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.