השג את כל סוכני הסריקה
חל על:
רוצה להתנסות ב- Microsoft Defender עבור נקודת קצה? הירשם לקבלת גירסת ניסיון ללא תשלום.
רוצה להיתקל בניהול פגיעויות של Microsoft Defender? גלה כיצד להירשם לקבלת גירסת ניסיון ללא תשלום.
חשוב
חלק מהמידע במאמר זה מתייחס למוצר שהופץ מראש, אשר עשוי להיות שונה באופן משמעותי לפני ההפצה המסחרית שלו. Microsoft אינה מעניקה כל אחריות, מפורשת או משתמעת, ביחס למידע המסופק כאן.
הערה
אם אתה לקוח של ממשלת ארה"ב, השתמש ב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
אחזור רשימה של כל סוכני הסריקה.
מגבלות
- דרג מגבלות עבור API זה הן 100 שיחות בדקה ו- 1500 שיחות בשעה.
הרשאות
אחת מההרשאות הבאות נדרשת כדי לקרוא ל- API זה. לקבלת מידע נוסף, כולל כיצד לבחור הרשאות, ראה שימוש ב- Microsoft Defender עבור ממשקי API של נקודת קצה.
סוג הרשאה | הרשאה | שם תצוגה של הרשאה |
---|---|---|
יישום | Machine.Read.All | קרא את כל מידע הסריקה. |
מוסמך (חשבון בעבודה או בבית ספר) | Machine.Read.All | קרא את כל מידע הסריקה. |
הערה
בעת השגת אסימון באמצעות אישורי משתמש:
- כדי להציג נתונים, המשתמש זקוק לפחות להרשאות התפקיד הבאות: 'ViewData' או 'TvmViewData' (ראה יצירה וניהול של תפקידים לקבלת מידע נוסף)
בקשת HTTP
GET /api/DeviceAuthenticatedScanAgents
כותרות בקשות
Name | סוג | תיאור |
---|---|---|
ההרשאות | מחרוזת | נושא {token}. נדרש . |
גוף הבקשה
ריק
תגובה
אם שיטה זו מצליחה, היא מחזירה קוד תגובה של 200 - אישור עם רשימה של סוכני סריקה מאומתים.
דוגמה
דוגמה לבקשה
להלן דוגמה של הבקשה.
https://api-us.securitycenter.microsoft.com/api/DeviceAuthenticatedScanAgents
דוגמה לתגובה
להלן דוגמה לתגובה.
{
"@odata.context": "https://api-us.securitycenter.microsoft.com/api/$metadata#DeviceAuthenticatedScanAgents",
"value": [
{
"id": "47df41a0c-asad-4fd6d3-bbea-a93dbc0bfcaa_4edd75b2407a5b64d704b4e53d74f15",
"machineId": "4ejh675b240118fbehiuiy5b64d704b4e53d15",
"lastSeen": "2022-05-08T12:18:41.538203Z",
"computerDnsName": "TEST_DOMAIN",
"AssignedApplicationId": "9E0FA0EB-0A51-4357-9C87-C21BFBE07571",
"ScannerSoftwareVersion": "7.1.1",
"LastCommandExecutionTimestamp": "2022-05-08T12:18:41.538203Z",
"mdeClientVersion": "10.8295.22621.1195"
},
{
"id": "47d41a0c-1dfd-46d3-bbea-a93dbc0bfcaa_eb663a27ae9d032f61bc268oiu4c4b90f77",
"machineId": "eb663a27ae9d032sdf9dfd79eedf14c4b90f77",
"lastSeen": "2022-12-19T20:29:04.8242449Z",
"computerDnsName": "TEST_DOMAIN2",
"AssignedApplicationId": "9E0FA0EB-0A51-4357-9C87-C21BFBE07571",
"ScannerSoftwareVersion": "7.1.1",
"LastCommandExecutionTimestamp": "2022-12-19T20:29:04.8242449Z",
"mdeClientVersion": "10.8295.22621.1010"
},
]
}
עצה
האם ברצונך לקבל מידע נוסף? צור קשר עם קהילת האבטחה של Microsoft בקהילה הטכנית שלנו: Microsoft Defender for Endpoint Tech Community.