Secure Score voor apparaten ophalenGet device secure score

Van toepassing op:Applies to:

Van toepassing op: Microsoft Defender voor EindpuntApplies to: Microsoft Defender for Endpoint

Notitie

Als u een klant van de Amerikaanse overheid bent, gebruikt u de URL's die worden vermeld in Microsoft Defender voor Eindpunt voor klanten van de Amerikaanse overheid.If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

Tip

Voor betere prestaties kunt u de server dichter bij uw geografische locatie gebruiken: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

Haalt uw Microsoft Secure Score voor apparaten op.Retrieves your Microsoft Secure Score for Devices. Een hogere Microsoft Secure Score voor apparaten betekent dat uw eindpunten beter bestand zijn tegen cyberbeveiligingsaanvallen.A higher Microsoft Secure Score for Devices means your endpoints are more resilient from cybersecurity threat attacks.

MachtigingenPermissions

Een van de volgende machtigingen is vereist om deze API te bellen.One of the following permissions is required to call this API. Zie Microsoft Defender voor eindpunt-API's gebruiken voor meer informatie, inclusief het kiezen van machtigingen.To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

MachtigingstypePermission type MachtigingPermission Weergavenaam machtigingPermission display name
ToepassingApplication Score.Read.AlllScore.Read.Alll 'Score bedreigings- en kwetsbaarheidsbeheer lezen''Read Threat and Vulnerability Management score'
Gedelegeerd (werk- of schoolaccount)Delegated (work or school account) Score.ReadScore.Read 'Score bedreigings- en kwetsbaarheidsbeheer lezen''Read Threat and Vulnerability Management score'

HTTP-aanvraagHTTP request

GET /api/configurationScore

Kopteksten aanvragenRequest headers

NaamName TypeType BeschrijvingDescription
AutorisatieAuthorization TekenreeksString Bearer {token}.Bearer {token}. Vereist.Required.

Body aanvragenRequest body

LeegEmpty

AntwoordResponse

Als dit is gelukt, retourneert deze methode 200 OK, waarbij de veilige scoregegevens van het apparaat in de antwoord-body worden gebruikt.If successful, this method returns 200 OK, with the device secure score data in the response body.

VoorbeeldExample

AanvraagRequest

Hier is een voorbeeld van de aanvraag.Here is an example of the request.

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

AntwoordResponse

Hier is een voorbeeld van het antwoord.Here is an example of the response.

Notitie

De hier weergegeven antwoordlijst kan worden afgekapt voor beknoptheid.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
}

Zie ookSee also