שתף באמצעות

קבל API של פרטי אירוע

  • מאמר

חל על:

רוצה להתנסות ב- Microsoft Defender עבור נקודת קצה? הירשם לקבלת גירסת ניסיון ללא תשלום.

הערה

אם אתה לקוח של ממשלת ארה"ב, השתמש בURI המפורטים ב- Microsoft Defender עבור נקודת קצה עבור לקוחות של ממשלת ארה"ב.

עצה

לקבלת ביצועים טובים יותר, באפשרותך להשתמש בשרת קרוב יותר למיקום הגיאוגרפי שלך:

  • 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

הערה

נסה את ממשקי ה- API החדשים שלנו באמצעות API של אבטחה של MS Graph. קבל מידע נוסף ב: השתמש ב- API לאבטחה של Microsoft Graph - Microsoft Graph | Microsoft Learn.

תיאור API

אחזור מקרה ספציפי לפי המזהה שלו

מגבלות

  1. דרג מגבלות עבור API זה הן 100 שיחות בדקה ו- 1,500 שיחות בשעה.

הרשאות

אחת מההרשאות הבאות נדרשת כדי לקרוא ל- API זה.

סוג הרשאה הרשאה שם תצוגה של הרשאה
יישום Incident.Read.All Read all Incidents
יישום Incident.ReadWrite.All Read and write all Incidents
מוסמך (חשבון בעבודה או בבית ספר) אירוע.קריאה Read Incidents
מוסמך (חשבון בעבודה או בבית ספר) Incident.ReadWrite Read and write Incidents

הערה

בעת השגת אסימון באמצעות אישורי משתמש:

  • המשתמש צריך להיות בעל הרשאת התפקיד הבאה לפחות: View Data
  • התגובה תכלול רק מקרים שהמשתמש נחשף אליהם

בקשת HTTP

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

כותרות בקשות

Name סוג תיאור
ההרשאות מחרוזת נושא {token}. נדרש .

גוף הבקשה

ריק

תגובה

אם שיטה זו הצליחה 200 OK, שיטה זו מחזירה את ישות האירוע בגוף התגובה. אם מקרה עם המזהה שצוין לא נמצא - 404 לא נמצא.

דוגמה

בקשה

להלן דוגמה לבקשה.

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

השתמש ב- API של אבטחת Microsoft Graph - Microsoft Graph | Microsoft Learn

עצה

האם ברצונך לקבל מידע נוסף? צור קשר עם קהילת האבטחה של Microsoft בקהילת הטכנולוגיה שלנו: קהילת האבטחה של Microsoft Defender XDR.