Jaa

Hae koneeseen liittyvien hälytysten ohjelmointirajapinta

  • Artikkeli

Koskee seuraavia:

Haluatko kokea Microsoft Defender for Endpointin? Rekisteröidy maksuttomaan kokeiluversioon.

Huomautus

Jos olet Yhdysvaltain valtionhallinnon asiakas, käytä Microsoft Defender for Endpoint for Us Government -asiakkaille lueteltuja URI-osoitteita.

Vihje

Suorituskyvyn parantamiseksi voit käyttää palvelinta lähempänä maantieteellistä sijaintiasi:

  • 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

Ohjelmointirajapinnan kuvaus

Hakee kaikki tiettyyn laitteeseen liittyvät ilmoitukset .

Rajoitukset

  1. Voit tehdä kyselyjä laitteissa, jotka on viimeksi päivitetty määritetyn säilytysajan mukaan.
  2. Tämän ohjelmointirajapinnan nopeusrajoitukset ovat 100 puhelua minuutissa ja 1 500 puhelua tunnissa.
Käyttöoikeustyyppi Lupa Käyttöoikeuden näyttönimi
Sovellus Alert.Read.All Lue kaikki ilmoitukset
Sovellus Alert.ReadWrite.All 'Kaikkien ilmoitusten luku- ja kirjoitusoikeudet'
Delegoitu (työpaikan tai oppilaitoksen tili) Alert.Read Lue ilmoitukset
Delegoitu (työpaikan tai oppilaitoksen tili) Alert.ReadWrite "Ilmoitusten lukeminen ja kirjoittaminen"

Huomautus

Kun hankit tunnuksen käyttäjän tunnistetiedoilla:

  • Käyttäjällä on oltava vähintään seuraava roolioikeus: Näytä tiedot. Lisätietoja käyttöoikeuksista on artikkelissa Roolien luominen ja hallinta.
  • Käyttäjällä on oltava laitteen käyttöoikeus laiteryhmän asetusten perusteella. Lisätietoja laiteryhmän asetuksista on kohdassa Laiteryhmien luominen ja hallinta.

Laiteryhmän luontia tuetaan Defender for Endpoint -palvelupaketti 1:ssä ja palvelupakettissa 2.

HTTP-pyyntö

GET /api/machines/{id}/alerts

Pyynnön otsikot

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

Pyynnön leipäteksti

Tyhjä

Vastaus

Jos tämä onnistuu ja laite on olemassa: 200 OK ja ilmoitusentiteettien luettelo leipätekstissä. Jos laitetta ei löytynyt: 404 Ei löytynyt.

Vihje

Haluatko tietää lisää? Ole yhteydessä Microsoft Security -yhteisöön teknologiayhteisössämme: Microsoft Defender for Endpoint Tech -yhteisössä.