Sdílet prostřednictvím

Rozhraní API pro získání informací o incidentech

  • Č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 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

Poznámka

Vyzkoušejte naše nová rozhraní API s využitím rozhraní MS Graph Security API. Další informace najdete v tématu : Použití rozhraní Microsoft Graph Security API – Microsoft Graph | Microsoft Learn.

Popis rozhraní API

Načte konkrétní incident podle jeho ID.

Omezení

  1. Omezení rychlosti pro toto rozhraní API jsou 100 volání za minutu a 1 500 volání za hodinu.

Oprávnění

K volání tohoto rozhraní API se vyžaduje jedno z následujících oprávnění.

Typ oprávnění Oprávnění Zobrazovaný název oprávnění
Application Incident.Read.All Read all Incidents
Application Incident.ReadWrite.All Read and write all Incidents
Delegovaný (pracovní nebo školní účet) Incident.Read Read Incidents
Delegovaný (pracovní nebo školní účet) Incident.ReadWrite Read and write Incidents

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: View Data
  • Odpověď bude obsahovat pouze incidenty, kterým je uživatel vystaven.

Požadavek HTTP

GET .../api/incidents/{id}

Hlavičky požadavků

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

Text požadavku

Prázdné

Reakce

Pokud je tato metoda úspěšná, vrátí 200 OKv těle odpovědi entitu a entitu incidentu. Pokud se incident se zadaným ID nenašel – 404 Nenalezena.

Příklad

Požadavek

Tady je příklad požadavku.

GET https://api.security.microsoft.com/api/incidents/{id}

Použití rozhraní Microsoft Graph Security API – Microsoft Graph | Microsoft Learn

Tip

Chcete se dozvědět více? Spojte se s komunitou zabezpečení společnosti Microsoft v naší technické komunitě: Technická komunita Microsoft Defender XDR.