Blootstellingsscore ophalenGet exposure score

Van toepassing op:Applies to:

Wilt u Microsoft Defender voor Eindpunt ervaren?Want to experience Microsoft Defender for Endpoint? Meld u aan voor een gratis proefabonnement.Sign up for a free trial.

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

Belangrijk

Sommige informatie is gerelateerd aan voorlopige productversies die mogelijk aanzienlijk gewijzigd worden voordat ze commercieel gepubliceerd worden.Some information relates to prereleased product which may be substantially modified before it's commercially released. Microsoft geeft geen garantie, uitdrukkelijk of impliciet, met betrekking tot de informatie die hier wordt beschreven.Microsoft makes no warranties, express or implied, with respect to the information provided here.

Hiermee wordt de score voor de blootstelling van de organisatie opgehaald.Retrieves the organizational exposure score.

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

MachtigingstypePermission type MachtigingPermission Weergavenaam machtigingPermission display name
ToepassingApplication Score.Read.AllScore.Read.All '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/exposureScore

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, met de blootstellingsgegevens in de antwoord body.If successful, this method returns 200 OK, with the exposure 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/exposureScore

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#ExposureScore/$entity",
    "time": "2019-12-03T07:23:53.280499Z",
    "score": 33.491554051195706
}

Zie ookSee also