Hae hälytyksiin liittyvien IPS-tietojen ohjelmointirajapinta

Ohjelmointirajapinnan kuvaus

Hakee kaikki tiettyyn ilmoitukseen liittyvät IPS:t.

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 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.
• Käyttäjällä on oltava laitteen ryhmäasetusten perusteella käyttöoikeus hälytykseen liittyvään laitteeseen. 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	Ip.Read.All	"Lue IP-osoiteprofiilit"
Delegoitu (työpaikan tai oppilaitoksen tili)	Ip.Read.All	"Lue IP-osoiteprofiilit"

HTTP-pyyntö

GET /api/alerts/{id}/ips

Pyynnön otsikot

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

Pyynnön leipäteksti

Tyhjä

Vastaus

Jos onnistuminen ja ilmoitus sekä IP-osoite ovat olemassa - 200 OK. Jos ilmoitusta ei löydy - 404 Ei löytynyt.

Esimerkki

Esimerkkipyyntö

Tässä on esimerkki pyynnöstä.

GET https://api.security.microsoft.com/alerts/636688558380765161_2136280442/ips

Vastausesimerkki

Tässä on esimerkki vastauksesta.

{
    "@odata.context": "https://api.security.microsoft.com/$metadata#Ips",
    "value": [
                {
                    "id": "104.80.104.128"
                },
                {
                    "id": "23.203.232.228
                }
                ...
    ]
}