Olvasás angol nyelven

Megosztás a következőn keresztül:


Incidensinformációs API lekérése

Érintett szolgáltatás:

Szeretné megismerni a Végponthoz készült Microsoft Defendert? Regisztráció az ingyenes próbaverzióra

Megjegyzés

Ha Ön az USA kormányzati szerveinek ügyfele, használja az USA kormányzati ügyfeleinek készült Végponthoz készült Microsoft Defenderben felsorolt URI-kat.

Tipp.

A jobb teljesítmény érdekében a földrajzi helyhez közelebbi kiszolgálót használhat:

  • 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

Megjegyzés

Próbálja ki az új API-kat az MS Graph security API használatával. További információ: A Microsoft Graph biztonsági API használata – Microsoft Graph | Microsoft Learn.

API-leírás

Lekér egy adott incidenst az azonosítója alapján

Korlátozások

  1. Az API sebességkorlátozásai percenként 100 hívás, óránként 1500 hívás.

Engedélyek

Az API meghívásához az alábbi engedélyek egyikére van szükség.

Engedély típusa Engedély Engedély megjelenítendő neve
Alkalmazás Incident.Read.All Read all Incidents
Alkalmazás Incident.ReadWrite.All Read and write all Incidents
Delegált (munkahelyi vagy iskolai fiók) Incident.Read Read Incidents
Delegált (munkahelyi vagy iskolai fiók) Incident.ReadWrite Read and write Incidents

Megjegyzés

Jogkivonat felhasználói hitelesítő adatokkal történő beszerzésekor:

  • A felhasználónak legalább a következő szerepköri engedéllyel kell rendelkeznie: View Data
  • A válasz csak azokat az incidenseket tartalmazza, amelyeknek a felhasználó ki van téve

HTTP-kérés

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

Kérelemfejlécek

Name (Név) Típus Leírás
Felhatalmazás Karakterlánc Tulajdonos : {token}. Kötelező megadni.

Kérelem törzse

Üres

Válasz

Ha a metódus sikeres, a visszaadja 200 OKa értéket, és az incidens entitást a válasz törzsében. Ha a megadott azonosítóval rendelkező incidens nem található – 404 Nem található.

Példa

Kérés

Íme egy példa a kérésre.

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

A Microsoft Graph biztonsági API használata – Microsoft Graph | Microsoft Learn

Tipp.

Szeretne többet megtudni? Lépjen kapcsolatba a Microsoft biztonsági közösségével a technikai közösségünkben: Microsoft Defender XDR Tech Community.