ביטול API של פעולת מחשב

  • מאמר

חל על:

חשוב

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

רוצה להתנסות ב- 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

ביטול פעולת מחשב שכבר הופעלה שאינה נמצאת עדיין במצב סופי (הושלמה, בוטלה, נכשלה).

מגבלות

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

הרשאות

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

סוג הרשאה הרשאה שם תצוגה של הרשאה
יישום Machine.CollectForensics
מחשב. מבודד
Machine.RestrictExecution
Machine.Scan
Machine.Offboard
Machine.StopAndQuarantine
Machine.LiveResponse		 איסוף מעבדה לזיהוי פלילי
בידוד מחשב
הגבלת ביצוע קוד
מכונת סריקה
הסר מחשב
עצור והסגר
הפעלת תגובה חיה במחשב ספציפי
מוסמך (חשבון בעבודה או בבית ספר) Machine.CollectForensics
מחשב. מבודד
Machine.RestrictExecution
Machine.Scan
Machine.Offboard
Machine.StopAndQuarantineMachine.LiveResponse		 איסוף מעבדה לזיהוי פלילי
בידוד מחשב
הגבלת ביצוע קוד
מכונת סריקה
הסר מחשב
עצור והסגר
הפעלת תגובה חיה במחשב ספציפי

בקשת HTTP

POST https://api.securitycenter.microsoft.com/api/machineactions/<machineactionid>/cancel

כותרות בקשות

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

גוף הבקשה

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

תגובה

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

דוגמה

בקשה

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

POST
https://api.securitycenter.microsoft.com/api/machineactions/988cc94e-7a8f-4b28-ab65-54970c5d5018/cancel

{
    "Comment": "Machine action was canceled by automation"
}

מאמר קשור

עצה

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