שתף באמצעות

רשימת ניקוד חשיפה לפי קבוצת מכשירים

  • מאמר

חל על:

רוצה לחוות את 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 אינה מעניקה כל אחריות, מפורשת או משתמעת, ביחס למידע המסופק כאן.

מאחזר את ניקוד החשיפה עבור כל קבוצת מכונה.

הרשאות

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

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

בקשת HTTP

GET /api/exposureScore/ByMachineGroups

כותרות בקשות

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

גוף הבקשה

ריק

תגובה

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

דוגמה

בקשה לדוגמה

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

GET https://api.securitycenter.microsoft.com/api/exposureScore/ByMachineGroups

תגובה לדוגמה

להלן דוגמה לתגובה.

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#ExposureScore",
    "value": [
        {
            "time": "2019-12-03T09:51:28.214338Z",
            "score": 41.38041766305988,
            "rbacGroupName": "GroupOne"
        },
        {
            "time": "2019-12-03T09:51:28.2143399Z",
            "score": 37.403726933165366,
            "rbacGroupName": "GroupTwo"
        }
        ...
    ]
}

עצה

האם ברצונך לקבל מידע נוסף? צור קשר עם קהילת האבטחה של Microsoft בקהילה הטכנית שלנו: Microsoft Defender for Endpoint Tech Community.