Aracılığıyla paylaş

Olay bilgileri API'si alma

  • Makale

Şunlar için geçerlidir:

Uç Nokta için Microsoft Defender'ı deneyimlemek ister misiniz? Ücretsiz deneme için kaydolun.

Not

ABD Kamu müşterisiyseniz lütfen US Government müşterileri için Uç Nokta için Microsoft Defender'da listelenen URI'leri kullanın.

İpucu

Daha iyi performans için coğrafi konumunuza daha yakın olan sunucuyu kullanabilirsiniz:

  • 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

Not

MS Graph güvenlik API'lerini kullanarak yeni API'lerimizi deneyin. Daha fazla bilgi için bkz. Microsoft Graph güvenlik API'sini kullanma - Microsoft Graph | Microsoft Learn.

API açıklaması

Kimliğine göre belirli bir olayı alır

Sınırlamalar

  1. Bu API için hız sınırlamaları dakikada 100 çağrı ve saatte 1.500 çağrıdır.

İzinler

Bu API'yi çağırmak için aşağıdaki izinlerden biri gereklidir.

İzin türü İzin İzin görünen adı
Uygulama Incident.Read.All Read all Incidents
Uygulama Incident.ReadWrite.All Read and write all Incidents
Temsilci (iş veya okul hesabı) Incident.Read Read Incidents
Temsilci (iş veya okul hesabı) Incident.ReadWrite Read and write Incidents

Not

Kullanıcı kimlik bilgilerini kullanarak belirteç alırken:

  • Kullanıcının en az aşağıdaki rol iznine sahip olması gerekir: View Data
  • Yanıt yalnızca kullanıcının maruz kaldığı olayları içerir

HTTP isteği

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

İstek üst bilgileri

Name Tür Açıklama
İzin Dize Taşıyıcı {token}. Gerekli.

İstek gövdesi

Boş

Yanıt

Başarılı olursa, bu yöntem , ve yanıt gövdesindeki olay varlığını döndürür 200 OK. Belirtilen kimlikle ilgili olay bulunamadıysa - 404 Bulunamadı.

Örnek

İstek

burada isteğin bir örneği verilmiş.

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

Microsoft Graph güvenlik API'sini kullanma - Microsoft Graph | Microsoft Learn

İpucu

Daha fazla bilgi edinmek mi istiyorsunuz? Teknoloji Topluluğumuzdaki Microsoft Güvenlik topluluğuyla etkileşime geçin: Microsoft Defender XDR Teknoloji Topluluğu.