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

Cikk
05/03/2024

É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 a Végponthoz készült Microsoft Defender-ben felsorolt URI-kat az USA kormányzati ügyfelei számára.

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

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
Engedélyezési	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.securitycenter.microsoft.com/api/configurationScore

Példa válaszra

Íme egy példa a válaszra.

Megjegyzés:

Az itt látható válaszlista a rövidség kedvéért csonkulhat.

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

Lásd még

OData-lekérdezések Végponthoz készült Microsoft Defender