שתף באמצעות

רשימת 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

מאחזר את מלאי התוכנה של הארגון.
תומך בשאילתות OData V4.
אופרטורים נתמכים של OData:
$filter ב: id, name, ומאפיינים vendor .
$top עם הערך המרבי של 10,000.
$skip.
ראה דוגמאות בשאילתות OData עם Microsoft Defender עבור נקודת קצה.

הרשאות

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

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

בקשת HTTP

GET /api/Software

כותרות בקשות

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

גוף הבקשה

ריק

תגובה

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

דוגמה

דוגמה לבקשה

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

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

דוגמה לתגובה

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

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#Software",
    "value": [
            {
                "id": "microsoft-_-edge",
                "name": "edge",
                "vendor": "microsoft",
                "weaknesses": 467,
                "publicExploit": true,
                "activeAlert": false,
                "exposedMachines": 172,
                "impactScore": 2.39947438
            }
            ...
        ]
}

עצה

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