Aracılığıyla paylaş


Olay bilgileri API'si alma

Not

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

İpucu

Daha iyi performans için api.security.microsoft.com kullanmak yerine coğrafi konumunuza daha yakın bir sunucu kullanı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
  • ina.api.security.microsoft.com
  • aea.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
Yetkilendirme 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

Istek

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.