Szoftverleltár API listázása
Érintett szolgáltatás:
Szeretné megismerni a Végponthoz készült Microsoft Defendert? Regisztráció az ingyenes próbaverzióra
Megjegyzés:
Ha Ön az USA kormányzati szerveinek ügyfele, használja az USA kormányzati ügyfeleinek készült Végponthoz készült Microsoft Defenderben felsorolt URI-kat.
Tipp
A jobb teljesítmény érdekében a földrajzi helyhez közelebbi kiszolgálót használhat:
- 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
API-leírás
Lekéri a szervezeti szoftverleltárat.
Támogatja az OData V4-lekérdezéseket.
OData által támogatott operátorok:
$filter
on: id
, name
és vendor
properties.
$top
legfeljebb 10 000 értékkel.
$skip
.
Példákat az OData-lekérdezések a Végponthoz készült Microsoft Defenderrel című témakörben talál.
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 | Software.Read.All | "Veszélyforrás- és biztonságirés-kezelési szoftverinformációk olvasása" |
Delegált (munkahelyi vagy iskolai fiók) | Software.Read | "Veszélyforrás- és biztonságirés-kezelési szoftverinformációk olvasása" |
HTTP-kérés
GET /api/Software
Kérelemfejlécek
Name (Név) | Típus | Leírás |
---|---|---|
Felhatalmazás | Karakterlánc | Tulajdonos : {token}. Kötelező megadni. |
Kérelem törzse
Üres
Válasz
Ha sikeres, ez a metódus 200 OK értéket ad vissza a törzsben lévő szoftverleltárral együtt.
Példa
Példa kérésre
Íme egy példa a kérésre.
GET https://api.security.microsoft.com/api/Software
Példa válaszra
Íme egy példa a válaszra.
{
"@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
}
...
]
}
Kapcsolódó témakörök
Tipp
Szeretne többet megtudni? Vegye fel a kapcsolatot a Microsoft Security közösségével a technikai közösségünkben: Microsoft Defender for Endpoint Tech Community.