Luetteloi altistumispisteet laiteryhmän mukaan

Tärkeää

Jotkin tämän artikkelin tiedot liittyvät tuotteen ennakkojulkaisuversioon, jota voidaan muuttaa huomattavasti ennen kaupallista julkaisua. Microsoft ei anna mitään takuita tässä annettujen tietojen suhteen.

Hakee kunkin koneryhmän altistumispisteet.

Käyttöoikeudet

Tämän ohjelmointirajapinnan kutsumiseen tarvitaan jokin seuraavista käyttöoikeuksista. Lisätietoja ja käyttöoikeuksien valitseminen on artikkelissa Microsoft Defender for Endpoint ohjelmointirajapintoja

Käyttöoikeustyyppi	Lupa	Käyttöoikeuden näyttönimi
Sovellus	Score.Read.All	Lue uhkien ja haavoittuvuuden hallinnan pisteet
Delegoitu (työpaikan tai oppilaitoksen tili)	Score.Read	Lue uhkien ja haavoittuvuuden hallinnan pisteet

HTTP-pyyntö

GET /api/exposureScore/ByMachineGroups

Pyynnön otsikot

Nimi	Kirjoita	Kuvaus
Lupa	Merkkijono	Haltija {token}. Pakollinen.

Pyynnön leipäteksti

Tyhjä

Vastaus

Jos tämä menetelmä onnistuu, se palauttaa arvon 200 OK, ja vastauksen leipätekstissä on luettelo altistumispisteistä laiteryhmän tietoja kohti.

Esimerkki

Esimerkkipyyntö

Tässä on esimerkki pyynnöstä.

GET https://api.security.microsoft.com/api/exposureScore/ByMachineGroups

Esimerkkivastaus

Tässä on esimerkki vastauksesta.

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#ExposureScore",
    "value": [
        {
            "time": "2019-12-03T09:51:28.214338Z",
            "score": 41.38041766305988,
            "rbacGroupName": "GroupOne"
        },
        {
            "time": "2019-12-03T09:51:28.2143399Z",
            "score": 37.403726933165366,
            "rbacGroupName": "GroupTwo"
        }
        ...
    ]
}