Hämta enhetens säkerhetspoängGet device secure score

Gäller för:Applies to:

Gäller för: Microsoft Defender för slutpunktApplies to: Microsoft Defender for Endpoint

Anteckning

Om du är myndighetskund i USA kan du använda de URI:er som visas i Microsoft Defender för Slutpunkt för kunder inom myndigheter i USA.If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

Tips

För bättre prestanda kan du använda servern närmare din geografiska plats:For better performance, you can use server closer to your geo location:

  • api-us.securitycenter.microsoft.comapi-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.comapi-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.comapi-uk.securitycenter.microsoft.com

Hämtar Microsoft Secure Score för enheter.Retrieves your Microsoft Secure Score for Devices. Ett högre Microsoft Secure Score för enheter innebär att dina slutpunkter är mer flexibel mot attacker mot hot om cyberhot.A higher Microsoft Secure Score for Devices means your endpoints are more resilient from cybersecurity threat attacks.

BehörigheterPermissions

En av följande behörigheter krävs för att anropa detta API.One of the following permissions is required to call this API. Mer information, inklusive hur du väljer behörigheter, finns i Använda Microsoft Defender för slutpunkts-API:er för mer information.To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

BehörighetstypPermission type BehörighetPermission Visningsnamn för behörighetPermission display name
ProgramApplication Score.Read.AlllScore.Read.Alll "Read Threat and Vulnerability Management Score"'Read Threat and Vulnerability Management score'
Delegerat (arbets- eller skolkonto)Delegated (work or school account) Score.ReadScore.Read "Read Threat and Vulnerability Management Score"'Read Threat and Vulnerability Management score'

HTTP-begäranHTTP request

GET /api/configurationScore

Begäran om rubrikerRequest headers

NamnName SkrivType BeskrivningDescription
AuktoriseringAuthorization SträngString Bearer {token}.Bearer {token}. Obligatoriskt.Required.

Begärans brödtextRequest body

TomEmpty

SvarResponse

Om det lyckas returnerar den här metoden 200 OK, med enhetens säkra poängdata i svarstexten.If successful, this method returns 200 OK, with the device secure score data in the response body.

ExempelExample

BegäranRequest

Här är ett exempel på begäran.Here is an example of the request.

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

SvarResponse

Här är ett exempel på svaret.Here is an example of the response.

Anteckning

Svarslistan som visas här kan trunkeras för att vara kort.The response list shown here may be truncated for brevity.

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

Se ävenSee also