קבל ציון מאובטח של המכשיר
חל על:
- Microsoft Defender עבור תוכנית 1 של נקודת קצה
- Microsoft Defender עבור תוכנית 2 של נקודת קצה
- Microsoft Defender XDR
רוצה להתנסות ב- 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
מאחזר את הניקוד המאובטח של Microsoft עבור מכשירים. ציון מאובטח גבוה יותר של Microsoft עבור מכשירים פירושו ש נקודות הקצה שלך גמישות יותר מפני תקיפות איומים של אבטחת סייבר.
הרשאות
אחת מההרשאות הבאות נדרשת כדי לקרוא ל- API זה. לקבלת מידע נוסף, כולל כיצד לבחור הרשאות, ראה שימוש בממשקי API של Microsoft Defender for Endpoint לקבלת פרטים.
סוג הרשאה | הרשאה | שם תצוגה של הרשאה |
---|---|---|
יישום | Score.Read.All | 'קרא את הציון 'ניהול איומים ופגיעות' |
מוסמך (חשבון בעבודה או בבית ספר) | Score.Read | 'קרא את הציון 'ניהול איומים ופגיעות' |
בקשת HTTP
GET /api/configurationScore
כותרות בקשות
Name | סוג | תיאור |
---|---|---|
ההרשאות | מחרוזת | נושא {token}. נדרש . |
גוף הבקשה
ריק
תגובה
אם שיטה זו מצליחה, היא מחזירה 200 אישור, כאשר המכשיר מאובטח נתוני ניקוד בגוף התגובה.
דוגמה
דוגמה לבקשה
להלן דוגמה של הבקשה.
GET https://api.securitycenter.microsoft.com/api/configurationScore
דוגמה לתגובה
להלן דוגמה לתגובה.
הערה
רשימת התגובות המוצגת כאן עשויה להיחתך לתדירות.
{
"@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#ConfigurationScore/$entity",
"time": "2019-12-03T09:15:58.1665846Z",
"score": 340
}
למידע נוסף
עצה
האם ברצונך לקבל מידע נוסף? צור קשר עם קהילת האבטחה של Microsoft בקהילה הטכנית שלנו: Microsoft Defender for Endpoint Tech Community.