קבל ציון מאובטח של המכשיר

מאחזר את הניקוד המאובטח של Microsoft עבור מכשירים. ציון מאובטח גבוה יותר של Microsoft עבור מכשירים פירושו ש נקודות הקצה שלך גמישות יותר מפני תקיפות איומים של אבטחת סייבר.

הרשאות

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

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

בקשת HTTP

GET /api/configurationScore

כותרות בקשות

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

גוף הבקשה

ריק

תגובה

אם שיטה זו מצליחה, היא מחזירה 200 אישור, כאשר המכשיר מאובטח נתוני ניקוד בגוף התגובה.

דוגמה

דוגמה לבקשה

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

GET https://api.security.microsoft.com/api/configurationScore

דוגמה לתגובה

להלן דוגמה של רשימת התגובות המוקצרת.

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#ConfigurationScore/$entity",
    "time": "2019-12-03T09:15:58.1665846Z",
    "score": 340
}