שתף באמצעות

קבל את היסטוריית הסריקה לפי הגדרה

  • מאמר

חל על:

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

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

חשוב

חלק מהמידע במאמר זה מתייחס למוצר שהופץ מראש, אשר עשוי להיות שונה באופן משמעותי לפני ההפצה המסחרית שלו. Microsoft אינה מעניקה כל אחריות, מפורשת או משתמעת, ביחס למידע המסופק כאן.

הערה

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

עצה

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

  • 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

תיאור API

מאחזר רשימה של היסטוריית הסריקה לפי הגדרות.

  • תומך בפעולות OData.
  • אופרטורים נתמכים של OData:
    • $top עם הערך המרבי של 4096. החזרת מספר ההפעלות שצוינו בבקשה.
    • $skip עם ערך ברירת מחדל של 0. מדלג על מספר ההפעלות שצוינו בבקשה.

לקבלת דוגמה לשימוש בפעולה של OData, ראה דוגמה $top בקשה.

מגבלות

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

הרשאות

אחת מההרשאות הבאות נדרשת כדי לקרוא ל- API זה. לקבלת מידע נוסף, כולל כיצד לבחור הרשאות, ראה שימוש ב- Microsoft Defender עבור ממשקי API של נקודת קצה.

סוג הרשאה הרשאה שם תצוגה של הרשאה
יישום Machine.Read.All קרא את כל מידע הסריקה.
מוסמך (חשבון בעבודה או בבית ספר) Machine.Read.All קרא את כל מידע הסריקה.

הערה

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

  • כדי להציג נתונים, המשתמש זקוק לפחות להרשאות התפקיד הבאות: 'ViewData' או 'TvmViewData' (ראה יצירה וניהול של תפקידים לקבלת מידע נוסף)

בקשת HTTP

POST api/DeviceAuthenticatedScanDefinitions/GetScanHistoryByScanDefinitionId

כותרות בקשות

Name סוג תיאור
ההרשאות מחרוזת נושא {token}. נדרש .
סוג תוכן מחרוזת application/json. נדרש .

גוף הבקשה

בגוף הבקשה, ספק אובייקט JSON עם הפרמטרים הבאים:

פרמטר סוג תיאור
ScanDefinitionIds מחרוזת מזהה הסריקה. נדרש.

תגובה

אם שיטה זו הצליחה, היא מחזירה 200 - קוד תגובה של אישור עם רשימה של היסטוריית הסריקה לפי הגדרה.

בקשה לדוגמה

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

POST https://api.securitycenter.microsoft.com/api/DeviceAuthenticatedScanDefinitions/GetScanHistoryByScanDefinitionId

{
    "ScanDefinitionIds": ["4ad8d463-6b3a-4894-b42a-a2de9ea0a8ae", "60c4aa57-c573-4488-8d18-230914792a92", "c6220f67-2cad-4ba3-a2fa-7ded6384da56"]
}

דוגמה לתגובה

{
"@odata.context": "https://api.securitycenter.microsoft.com/api/DeviceAuthenticatedScanDefinitions/GetScanHistoryByScanDefinitionId",
    "value": [
    {
    "ScanDefinitionIds": "4ad8d463-6b3a-4894-b42a-a2de9ea0a8ae",
    "LastScanned": "2022-12-20T11:14:24.5561791Z",
    "ScanStatus": "Partial Success",
    "ScannerId": "625431694b7d2ca9d07e77ca1b029ef216bebb6d"
    },
    {
    "ScanDefinitionIds": "60c4aa57-c573-4488-8d18-230914792a92",
    "LastScanned": "2022-11-17T15:13:24.5561791Z",
    "ScanStatus": "Partial Success",
    "ScannerId": "625431694b7d2ca9d07e77ca1b029ef216bebb6d"
    },
    {
    "ScanDefinitionIds": "c6220f67-2cad-4ba3-a2fa-7ded6384da56",
    "LastScanned": "2022-11-10T18:15:24.5561791Z",
    "ScanStatus": "Partial Success",
    "ScannerId": "625431694b7d2ca9d07e77ca1b029ef216bebb6d"
    },
   ]
}

דוגמה $top אישית

להלן דוגמה של בקשה המחזירה הפעלה אחת בלבד.

POST https://api.securitycenter.microsoft.com/api/DeviceAuthenticatedScanDefinitions/GetScanHistoryByScanDefinitionId?$top=1

$top דוגמה לתגובה

{
"@odata.context": "https://api.securitycenter.microsoft.com/api/DeviceAuthenticatedScanDefinitions/GetScanHistoryByScanDefinitionId",
    "value": [
    {
    "ScanDefinitionIds": "4ad8d463-6b3a-4894-b42a-a2de9ea0a8ae",
    "LastScanned": "2022-12-20T11:14:24.5561791Z",
    "ScanStatus": "Partial Success",
    "ScannerId": "625431694b7d2ca9d07e77ca1b029ef216bebb6d"
    },
 ]
}