Udostępnij za pośrednictwem

Uzyskiwanie interfejsu API informacji o zdarzeniu

  • Artykuł

Dotyczy:

Chcesz poznać usługę ochrony punktu końcowego w usłudze Microsoft Defender? Utwórz konto, aby skorzystać z bezpłatnej wersji próbnej.

Uwaga

Jeśli jesteś klientem rządowym USA, użyj identyfikatorów URI wymienionych w usłudze Microsoft Defender for Endpoint dla klientów rządowych USA.

Porada

Aby uzyskać lepszą wydajność, możesz użyć serwera bliżej lokalizacji geograficznej:

  • 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

Uwaga

Wypróbuj nasze nowe interfejsy API przy użyciu interfejsu API zabezpieczeń programu MS Graph. Dowiedz się więcej na stronie: Korzystanie z interfejsu API zabezpieczeń programu Microsoft Graph — Microsoft Graph | Microsoft Learn.

Opis interfejsu API

Pobiera określone zdarzenie według jego identyfikatora

Ograniczenia

  1. Ograniczenia szybkości dla tego interfejsu API to 100 wywołań na minutę i 1500 wywołań na godzinę.

Uprawnienia

Do wywołania tego interfejsu API jest wymagane jedno z następujących uprawnień.

Typ uprawnień Uprawnienie Nazwa wyświetlana uprawnień
Aplikacja Incident.Read.All Read all Incidents
Aplikacja Incident.ReadWrite.All Read and write all Incidents
Delegowane (konto służbowe) Incident.Read Read Incidents
Delegowane (konto służbowe) Incident.ReadWrite Read and write Incidents

Uwaga

Podczas uzyskiwania tokenu przy użyciu poświadczeń użytkownika:

  • Użytkownik musi mieć co najmniej następujące uprawnienia roli: View Data
  • Odpowiedź będzie obejmować tylko zdarzenia, na które użytkownik jest narażony

Żądanie HTTP

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

Nagłówki żądań

Name (Nazwa) Wpisać Opis
Autoryzacja Ciąg Element nośny {token}. Wymagane.

Treść żądania

Pusty

Odpowiedź

W przypadku powodzenia ta metoda zwraca 200 OKelement i jednostkę zdarzenia w treści odpowiedzi. Jeśli nie znaleziono zdarzenia o określonym identyfikatorze — nie znaleziono 404.

Przykład

Prosić

Oto przykład żądania.

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

Korzystanie z interfejsu API zabezpieczeń programu Microsoft Graph — Microsoft Graph | Microsoft Learn

Porada

Chcesz dowiedzieć się więcej? Zaangażuj się w społeczność rozwiązań zabezpieczających firmy Microsoft w naszej społeczności technicznej Społeczność techniczna usługi Microsoft Defender XDR.