Hae käyttäjään liittyvien ilmoitusten ohjelmointirajapinta - Microsoft Defender for Endpoint

Artikkeli
08/14/2024

Koskee seuraavia:

Haluatko kokeilla Defender for Endpointia? 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 tiettyyn käyttäjätunnukseen liittyvien ilmoitusten kokoelman.

Rajoitukset

Tämän ohjelmointirajapinnan nopeusrajoitukset ovat 100 puhelua minuutissa ja 1 500 puhelua tunnissa.

Käyttöoikeudet

Tämän ohjelmointirajapinnan kutsumiseen tarvitaan jokin seuraavista käyttöoikeuksista. Lisätietoja, mukaan lukien käyttöoikeuksien valitseminen, on artikkelissa Microsoft Defenderin käyttö päätepisteiden ohjelmointirajapinnoille

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 on artikkelissa Roolien luominen ja hallinta.
Vastaus sisältää vain laitteisiin liittyviä ilmoituksia, joihin käyttäjällä on käyttöoikeus laiteryhmän asetusten perusteella (lisätietoja on kohdassa Laiteryhmien luominen ja hallinta )

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

HTTP-pyyntö

GET /api/users/{id}/alerts

Tunnus ei ole täydellinen täydellinen käyttäjätunnus, vaan vain käyttäjänimi. (jos haluat esimerkiksi noutaa ilmoitukset käytölle user1@contoso.com /api/users/user1/alerts)

Pyynnön otsikot

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

Pyynnön leipäteksti

Tyhjä

Vastaus

Jos onnistui ja käyttäjä on olemassa - 200 OK. Jos käyttäjää ei ole olemassa - 200 OK ja tyhjä joukko.

Esimerkki

Pyytää

Tässä on esimerkki pyynnöstä.

GET https://api.securitycenter.microsoft.com/api/users/user1/alerts