Toimialueeseen liittyvien hälytysten ohjelmointirajapinnan hakeminen

Ohjelmointirajapinnan kuvaus

Hakee tiettyyn toimialueen osoitteeseen liittyvien ilmoitusten kokoelman.

Rajoitukset

• Voit tehdä kyselyjä ilmoituksista, jotka on päivitetty viimeksi määritetyn säilytysajan mukaan.
• Tämän ohjelmointirajapinnan nopeusrajoitukset ovat 100 puhelua minuutissa ja 1 500 puhelua tunnissa.

Käyttöoikeudet

Kun käyttäjätunnistetietojen avulla hankitaan tunnus, käyttäjällä on oltava vähintään seuraavat roolioikeudet: View Data. Lisätietoja on kohdassa Roolien luominen ja hallinta.

Vastaus sisältää laiteryhmän asetusten perusteella vain laitteisiin liittyviä ilmoituksia, joihin käyttäjällä on käyttöoikeus. Lisätietoja on kohdassa Laiteryhmien luominen ja hallinta.

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	Alert.ReadWrite.All	'Kaikkien ilmoitusten luku- ja kirjoitusoikeudet'
Delegoitu (työpaikan tai oppilaitoksen tili)	Alert.ReadWrite	"Ilmoitusten lukeminen ja kirjoittaminen"

HTTP-pyyntö

GET /api/domains/{domain}/alerts

Pyynnön otsikot

Otsikko	Arvo
Lupa	Merkkijono

Pyynnön leipäteksti

Tyhjä

Vastaus

Jos onnistui ja toimialue on olemassa - 200 OK hälytysentiteettien luettelolla. Jos toimialuetta ei ole - 200 OK ja tyhjä joukko.

Esimerkki

Pyytää

Tässä on esimerkki pyynnöstä.

GET https://api.security.microsoft.com/api/domains/client.wns.windows.com/alerts