שתף באמצעות

פרט את כל ההמלצות

  • מאמר

חל על:

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

אחזור רשימה של כל המלצות האבטחה המשפיעות על הארגון.

תיאור API

מחזירה מידע אודות כל המלצות האבטחה המשפיעות על הארגון.

כתובת URL: GET:/api/recommendations
תומך בשאילתות OData V4.
אופרטורים נתמכים של OData:
$filterב: id, productName, vendor, recommendedVersionrecommendationCategory, subCategory, severityScore, remediationType, recommendedProgram, recommendedVendor, ומאפייניםstatus.
$top עם הערך המרבי של 10,000.
$skip.
ראה דוגמאות בשאילתות OData עם Microsoft Defender for Endpoint.

הרשאות

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

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

בקשת HTTP

GET /api/recommendations

כותרות בקשות

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

גוף הבקשה

ריק

תגובה

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

דוגמה

בקשה

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

GET https://api.securitycenter.microsoft.com/api/recommendations

תגובה

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

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Recommendations",
    "value": [
        {
            "id": "va-_-microsoft-_-edge_chromium-based",
            "productName": "edge_chromium-based",
            "recommendationName": "Update Microsoft Edge Chromium-based to version 127.0.2651.74",
            "weaknesses": 762,
            "vendor": "microsoft",
            "recommendedVersion": "127.0.2651.74",
            "recommendedVendor": "",
            "recommendedProgram": "",
            "recommendationCategory": "Application",
            "subCategory": "",
            "severityScore": 0,
            "publicExploit": true,
            "activeAlert": false,
            "associatedThreats": [
                "71d9120e-7eea-4058-889a-1a60bbf7e312"
            ],
            "remediationType": "Update",
            "status": "Active",
            "configScoreImpact": 0,
            "exposureImpact": 1.1744086343876479,
            "totalMachineCount": 261,
            "exposedMachinesCount": 193,
            "nonProductivityImpactedAssets": 0,
            "relatedComponent": "Edge Chromium-based",
            "hasUnpatchableCve": false,
            "tags": [
            "internetFacing"
            ],
            "exposedCriticalDevices": 116
        }
     ]
}

למידע נוסף

עצה

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