קבל API של מחשבים הקשורים לתחום
חל על:
- Microsoft Defender עבור תוכנית 1 של נקודת קצה
- Microsoft Defender עבור תוכנית 2 של נקודת קצה
- Microsoft Defender XDR
רוצה להתנסות ב- 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
- ina.api.security.microsoft.com
תיאור API
מאחזר אוסף של מחשבים שהעבירו תקשורת אל כתובת תחום נתונה או מכתובת זו.
מגבלות
- באפשרותך לבצע שאילתה במכשירים עודכנו לאחרונה בהתאם לת תקופת השמירה שתצורתה נקבעה.
- דרג מגבלות עבור API זה הן 100 שיחות בדקה ו- 1500 שיחות בשעה.
- התגובות מוגבלות ל- 500 מכשירים בתוצאות.
הרשאות
אחת מההרשאות הבאות נדרשת כדי לקרוא ל- API זה. לקבלת מידע נוסף, כולל כיצד לבחור הרשאות, ראה שימוש בממשקי Microsoft Defender עבור נקודת קצה API
| סוג הרשאה | הרשאה | שם תצוגה של הרשאה |
|---|---|---|
| יישום | Machine.Read.All |
Read all machine profiles |
| יישום | Machine.ReadWrite.All |
Read and write all machine information |
| מוסמך (חשבון בעבודה או בבית ספר) | Machine.Read |
Read machine information |
| מוסמך (חשבון בעבודה או בבית ספר) | Machine.ReadWrite |
Read and write machine information |
הערה
בעת השגת אסימון באמצעות אישורי משתמש:
- למשתמש חייבת להיות לפחות הרשאת התפקיד הבאה:
View Data. לקבלת מידע נוסף, ראה יצירה וניהול של תפקידים. - התגובות כוללות רק מכשירים שהמשתמש יכול לגשת אליהם, בהתבסס על הגדרות קבוצת מכשירים. לקבלת מידע נוסף, ראה יצירה וניהול של קבוצות מכשירים. יצירת קבוצת מכשירים נתמכת ב- Defender for Endpoint Plan 1 ובתוכנית 2.
בקשת HTTP
GET /api/domains/{domain}/machines
כותרות בקשות
| Name | סוג | תיאור |
|---|---|---|
| ההרשאות | מחרוזת |
Bearer {token}. נדרש . |
גוף הבקשה
ריק
תגובה
אם הצליח, והתחום קיים:
- 200 אישור עם רשימה של ישויות מחשב
אם התחום אינו קיים:
- 200 אישור עם ערכה ריקה
דוגמה
בקשה
להלן דוגמה לבקשה.
GET https://api.securitycenter.microsoft.com/api/domains/api.securitycenter.microsoft.com/machines
עצה
האם ברצונך לקבל מידע נוסף? Engage עם קהילת האבטחה של Microsoft בקהילת הטכנולוגיה שלנו: Microsoft Defender עבור נקודת קצה Tech Community.