Získání informací o upozorněních podle rozhraní API ID

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 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í:

Popis rozhraní API

Načte konkrétní výstrahu podle svého ID.

Výstrahy můžete naposledy aktualizovat podle nakonfigurované doby uchovávání.
Omezení rychlosti pro toto rozhraní API jsou 100 volání za minutu a 1500 volání za hodinu.

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 Defender for Endpoint.

Typ oprávnění	Oprávnění	Zobrazovaný název oprávnění
Application	Alert.Read.All	Přečíst všechna upozornění
Application	Alert.ReadWrite.All	Čtení a zápis všech výstrah
Delegovaný (pracovní nebo školní účet)	Alert.Read	Čtení upozornění
Delegovaný (pracovní nebo školní účet)	Alert.ReadWrite	Upozornění na čtení a zápis

Poznámka

Při získávání tokenu pomocí přihlašovacích údajů uživatele:

Uživatel musí mít alespoň následující oprávnění role: Zobrazit data (další informace najdete v tématu Create a správa rolí).
Uživatel musí mít přístup k zařízení přidruženému k upozornění na základě nastavení skupiny zařízení (další informace najdete v tématu Create a správa skupin zařízení).

Vytváření skupin zařízení je podporováno v defenderu for Endpoint Plan 1 a Plan 2.

GET /api/alerts/{id}

Name (Název)	Typ	Popis
Autorizace	String	Nosný {token}. Povinné.

Prázdné

Pokud je tato metoda úspěšná, vrátí 200 OK a entitu upozornění v těle odpovědi. Pokud se upozornění se zadaným ID nenašlo, 404 Nenalezlo se.

Tip

Chcete se dozvědět více? Engage s komunitou Microsoft Security v naší technické komunitě: Microsoft Defender for Endpoint Tech Community.