חפש מכשירים לפי API של תגית

חל על:

• Microsoft Defender עבור תוכנית 1 של נקודת קצה
• Microsoft Defender עבור תוכנית 2 של נקודת קצה

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

חפש מחשבים לפי תגית.

startswith קיימת תמיכה בשאילתה.

מגבלות

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

הרשאות

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

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

הערה

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

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

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

בקשת HTTP

GET /api/machines/findbytag?tag={tag}&useStartsWithFilter={true/false}

כותרות בקשות

Name	סוג	תיאור
ההרשאות	מחרוזת	נושא {token}. נדרש .

בקש פרמטרים של URI

Name	סוג	תיאור
תג	מחרוזת	שם התגית. נדרש .
useStartsWithFilter	בוליאני	כאשר החיפוש מוגדר ל- True, החיפוש מוצא את כל המכשירים עם שם התג המתחילה עם התג הנתון בשאילתה. ברירת המחדל היא False. אופציונלי .

גוף הבקשה

ריק

תגובה

אם הצליח - 200 אישור עם רשימת המחשבים בגוף התגובה.

דוגמה

בקשה

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

GET https://api.securitycenter.microsoft.com/api/machines/findbytag?tag=testTag&useStartsWithFilter=true

עצה

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