Az összes javaslat listázása

Lekéri a szervezetet érintő összes biztonsági javaslat listáját.

API-leírás

Információkat ad vissza a szervezetet érintő összes biztonsági javaslatról.

URL: GET:/api/recommendations:

• Támogatja az OData V4-lekérdezéseket. OData által támogatott operátorok:
  • $filter a következő tulajdonságokon:
    • id
    • productName
    • vendor
    • recommendedVersion
    • recommendationCategory
    • subCategory
    • severityScore
    • remediationType
    • recommendedProgram
    • recommendedVendor
    • status
  • $top legfeljebb 10 000 értékkel.
  • $skip

Lásd a példákat az OData-lekérdezések Végponthoz készült Microsoft Defender.

Engedélyek

Az API meghívásához az alábbi engedélyek egyikére van szükség. További információ, többek között az engedélyek kiválasztása: Végponthoz készült Microsoft Defender API-k használata.

Engedély típusa	Engedély	Engedély megjelenítendő neve
Alkalmazás	SecurityRecommendation.Read.All	"Veszélyforrás- és biztonságirés-kezelési biztonsági javaslatok adatainak olvasása"
Delegált (munkahelyi vagy iskolai fiók)	SecurityRecommendation.Read	"Veszélyforrás- és biztonságirés-kezelési biztonsági javaslatok adatainak olvasása"

HTTP-kérés

GET /api/recommendations

Kérelemfejlécek

Name (Név)	Típus	Leírás
Engedélyezési	Karakterlánc	Tulajdonos : {token}. Kötelező megadni.

Kérelem törzse

Üres

Válasz

Ha a metódus sikeres, a 200 OK értéket adja vissza a törzsben található biztonsági javaslatok listájával együtt.

Példa

Kérés

Íme egy példa a kérésre.

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

Válasz

Íme egy példa a válaszra.

{
    "@odata.context": "https://api.security.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
        }
     ]
}