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
מאחזר אוסף של מחשבים שאיתם תקשרו Microsoft Defender עבור נקודת קצה הענן.
תומך בשאילתות OData V4.
השאילתה של OData $filter
נתמכת ב: computerDnsName
, id
, version
, deviceValue
, aadDeviceId
, machineTags
, lastSeen
,exposureLevel
onboardingStatus
, lastIpAddress
, , healthStatus
וosPlatform
riskScore
- rbacGroupId
.
$top
עם הערך המרבי של 10,000$skip
ראה דוגמאות בשאילתות OData עם Defender for Endpoint
מגבלות
- באפשרותך לקבל מכשירים שננראתה לאחרונה בהתאם לת תקופת השמירה שתצורתה נקבעה.
- גודל העמוד המרבי הוא 10,000.
- דרג מגבלות עבור API זה הן 100 שיחות בדקה ו- 1500 שיחות בשעה.
הרשאות
סוג הרשאה | הרשאה | שם תצוגה של הרשאה |
---|---|---|
יישום | Machine.Read.All | 'קרא את כל פרופילי המכונה' |
יישום | Machine.ReadWrite.All | 'קרא וכתוב את כל פרטי המכונה' |
מוסמך (חשבון בעבודה או בבית ספר) | מחשב. קריאה | 'קרא פרטי מחשב' |
מוסמך (חשבון בעבודה או בבית ספר) | Machine.ReadWrite | 'קרא וכתוב מידע מחשב' |
הערה
בעת השגת אסימון באמצעות אישורי משתמש:
- המשתמש צריך להיות בעל הרשאת התפקיד הבאה לפחות: 'הצגת נתונים' (לקבלת מידע נוסף, ראה Create ולנהל תפקידים)
- התגובה תכלול רק מכשירים, שלמשתמש יש גישה אליהם, בהתבסס על הגדרות קבוצת מכשירים (לקבלת מידע נוסף, ראה Create ולנהל קבוצות מכשירים)
יצירת קבוצת מכשירים נתמכת ב- Defender for Endpoint Plan 1 ובתוכנית 2.
בקשת HTTP
GET https://api.security.microsoft.com/api/machines
כותרות בקשות
Name | סוג | תיאור |
---|---|---|
ההרשאות | מחרוזת | נושא {token}. נדרש . |
גוף הבקשה
ריק
תגובה
אם קיימים מחשבים מוצלחים - 200 אישור עם רשימה של ישויות מחשב בגוף. אם לא נמצאו מחשבים אחרונים - 404 לא נמצא.
דוגמה
דוגמה לבקשה
להלן דוגמה לבקשה.
GET https://api.security.microsoft.com/api/machines
דוגמה לתגובה
להלן דוגמה לתגובה.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://api.security.microsoft.com/api/$metadata#Machines",
"value": [
{
"id": "1e5bc9d7e413ddd7902c2932e418702b84d0cc07",
"computerDnsName": "mymachine1.contoso.com",
"firstSeen": "2018-08-02T14:55:03.7791856Z",
"lastSeen": "2018-08-02T14:55:03.7791856Z",
"osPlatform": "Windows10" "Windows11",
"version": "1709",
"osProcessor": "x64",
"lastIpAddress": "172.17.230.209",
"lastExternalIpAddress": "167.220.196.71",
"osBuild": 18209,
"healthStatus": "Active",
"rbacGroupId": 140,
"rbacGroupName": "The-A-Team",
"riskScore": "Low",
"exposureLevel": "Medium",
"isAadJoined": true,
"aadDeviceId": "80fe8ff8-2624-418e-9591-41f0491218f9",
"machineTags": [ "test tag 1", "test tag 2" ]
}
...
]
}
מאמרים קשורים
עצה
האם ברצונך לקבל מידע נוסף? Engage עם קהילת האבטחה של Microsoft בקהילת הטכנולוגיה שלנו: Microsoft Defender עבור נקודת קצה Tech Community.
משוב
https://aka.ms/ContentUserFeedback.
בקרוב: במהלך 2024, נפתור בעיות GitHub כמנגנון המשוב לתוכן ונחליף אותו במערכת משוב חדשה. לקבלת מידע נוסף, ראה:שלח והצג משוב עבור