שתף באמצעות

הוספה או הסרה של תגית עבור מחשבים מרובים

  • מאמר

חל על:

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

הערה

אם אתה לקוח של ממשלת ארה"ב, השתמש ב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

הוספה או הסרה של תגית עבור קבוצת המחשבים שצוינה.

מגבלות

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

הרשאות

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

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

הערה

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

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

בקשת HTTP

POST https://api.securitycenter.microsoft.com/api/machines/AddOrRemoveTagForMultipleMachines

כותרות בקשות

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

גוף הבקשה

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

פרמטר סוג תיאור
ערך: מחרוזת שם התגית. נדרש .
פעולה ערך ספירה הוסף או הסר. הערכים המותרים הם: 'הוסף' או 'הסר'. נדרש .
מזהה מכונה רשימה (מחרוזת) רשימת זהות מחשב לעדכון. חובה.

תגובה

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

בקשה לדוגמה

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

POST https://api.securitycenter.microsoft.com/api/machines/AddOrRemoveTagForMultipleMachines

{
  "Value" : "Tag",
  "Action": "Add",
  "MachineIds": ["34e83ca3feea4dae2353006ba389262c033a025e",
  "2a398439b4975924e87a65943972bc702469b329",
  "a610c00c65fdf79960cc0077d9d8c569d23f09a5"]
}

כדי להסיר תגיות מחשב, הגדר את הפעולה ל'הסר' במקום 'הוסף' בגוף הבקשה.

עצה

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