שתף באמצעות

הגדר 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

הגדר את ערך ההתקן של מחשב ספציפי.
ראה הקצאת ערכי מכשיר לקבלת מידע נוסף.

מגבלות

  1. באפשרותך לפרסם במכשירים שנראה לאחרונה בהתאם לת תקופת השמירה שתצורתה נקבעה.
  2. דרג מגבלות עבור API זה הן 100 שיחות בדקה ו- 1500 שיחות בשעה.

הרשאות

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

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

הערה

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

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

בקשת HTTP

POST https://api.security.microsoft.com/api/machines/{machineId}/setDeviceValue

כותרות בקשות

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

גוף הבקשה

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

פרמטר סוג תיאור
ערך מכשיר Enum ערך המכשיר. הערכים המותרים הם: 'רגילה', 'נמוכה' ו'גבוהה'. נדרש .

תגובה

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

דוגמה

בקשה

להלן דוגמה לבקשה שתוסיף תג מחשב.

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

{
  "DeviceValue" : "High"
}

עצה

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