Získání ukazatele vystavení rizikům
Platí pro:
- Plán 1 pro Microsoft Defender for Endpoint
- Plán 2 pro Microsoft Defender pro koncový bod
- Microsoft Defender XDR
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
Důležité
Některé informace v tomto článku se týkají předvydaného produktu, který může být před komerčním vydáním podstatně změněn. Společnost Microsoft neposkytuje na zde uvedené informace žádné záruky, vyjádřené ani předpokládané.
Načte skóre expozice organizace.
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ě postupu výběru oprávnění, najdete v tématu Použití rozhraní API Microsoft Defenderu for Endpoint.
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/exposureScore
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 expozičními daty v těle odpovědi.
Příklad
Prosba
Tady je příklad požadavku.
GET https://api.security.microsoft.com/api/exposureScore
Odpověď
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.security.microsoft.com/api/$metadata#ExposureScore/$entity",
"time": "2019-12-03T07:23:53.280499Z",
"score": 33.491554051195706
}
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.