Eszköz biztonsági pontszámának lekérése

Lekéri a Microsoft eszközbiztonsági pontszámát. A Microsoft magasabb eszközbiztonsági pontszáma azt jelenti, hogy a végpontok rugalmasabbak a kiberbiztonsági fenyegetésekkel szemben.

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	Score.Read.All	"Veszélyforrás- és biztonságirés-kezelési pontszám olvasása"
Delegált (munkahelyi vagy iskolai fiók)	Score.Read	"Veszélyforrás- és biztonságirés-kezelési pontszám olvasása"

HTTP-kérés

GET /api/configurationScore

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, az eszköz biztonsági pontszámának adataival együtt a válasz törzsében.

Példa

Példa kérésre

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

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

Példa válaszra

Íme egy példa a rövidített válaszlistára.

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#ConfigurationScore/$entity",
    "time": "2019-12-03T09:15:58.1665846Z",
    "score": 340
}