הפעל 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

הפעל Microsoft Defender אנטי-וירוס במכשיר.

מגבלות

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

הערה

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

חשוב

  • פעולה זו זמינה עבור מכשירים בגירסה Windows 10, בגירסה 1709 ואילך ובמכשירים Windows 11.
  • סריקת Microsoft Defender אנטי-וירוס יכולה לפעול לצד פתרונות אנטי-וירוס אחרים, בין אם אנטי Microsoft Defender אנטי-וירוס הוא פתרון האנטי-וירוס הפעיל או לא. Microsoft Defender האנטי-וירוס יכול להיות במצב פאסיבי. לקבלת מידע נוסף, ראה Microsoft Defender אנטי-וירוס.

הרשאות

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

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

הערה

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

יצירת קבוצת מכשירים נתמכת ב- Defender for Endpoint Plan 1 ובתוכנית 2.

בקשת HTTP

POST https://api.security.microsoft.com/api/machines/{id}/runAntiVirusScan

כותרות בקשות

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

גוף הבקשה

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

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

ScanType שולט בסוג הסריקה שיש לבצע והוא יכול להיות אחד מהמצבים הבאים:

  • מהיר: ביצוע סריקה מהירה במכשיר
  • מלא: בצע סריקה מלאה במכשיר

תגובה

אם הפעולה הצליחה, שיטה זו מחזירה 201, קוד תגובה שנוצר והאובייקט MachineAction בגוף התגובה.

אם אתה שולח קריאות API מרובות כדי להפעיל סריקת אנטי-וירוס עבור אותו מכשיר, היא מחזירה "פעולת מחשב ממתינה" או HTTP 400 עם ההודעה "הפעולה כבר מתבצעת".

דוגמה

בקשה

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

POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/runAntiVirusScan 

{
  "Comment": "Check machine for viruses due to alert 3212",
  "ScanType": "Full"
}

עצה

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