Hämta enhetens säkerhetspoäng

Artikel
08/14/2024

Gäller för:

Vill du uppleva Microsoft Defender för Endpoint? Registrera dig för en kostnadsfri utvärderingsversion.

Obs!

Om du är en us government-kund använder du de URI:er som anges i Microsoft Defender för Endpoint för amerikanska myndighetskunder.

Tips

För bättre prestanda kan du använda servern närmare din geoplats:

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

Hämtar din Microsoft Secure Score för enheter. En högre Microsoft Secure Score för enheter innebär att dina slutpunkter är mer motståndskraftiga mot cybersäkerhetshotattacker.

Behörigheter

En av följande behörigheter krävs för att anropa det här API:et. Mer information, inklusive hur du väljer behörigheter, finns i Använda Api:er för Microsoft Defender för Endpoint för mer information.

Behörighetstyp	Behörighet	Visningsnamn för behörighet
Program	Score.Read.All	"Read Threat and Vulnerability Management score" (Läs poäng för hantering av hot och sårbarheter)
Delegerat (arbets- eller skolkonto)	Score.Read	"Read Threat and Vulnerability Management score" (Läs poäng för hantering av hot och sårbarheter)

HTTP-begäran

GET /api/configurationScore

Frågerubriker

Namn	Typ	Beskrivning
Tillstånd	Sträng	Ägaren {token}. Krävs.

Frågebrödtext

Tom

Svar

Om det lyckas returnerar den här metoden 200 OK, med enhetens säkerhetspoängdata i svarstexten.

Exempel

Exempel på begäran

Här är ett exempel på begäran.

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

Svarsexempel

Här är ett exempel på svaret.

Obs!

Svarslistan som visas här kan trunkeras för korthet.

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

Se även

OData-frågor med Microsoft Defender för Endpoint