Jaa

Tapaustietojen ohjelmointirajapinnan hankkiminen

  • 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

Huomautus

Kokeile uusia ohjelmointirajapintojamme MS Graphin suojauksen ohjelmointirajapinnan avulla. Lisätietoja on osoitteessa: Microsoft Graph -suojauksen ohjelmointirajapinnan käyttäminen - Microsoft Graph | Microsoft Learn.

Ohjelmointirajapinnan kuvaus

Noutaa tietyn tapauksen sen tunnuksen mukaan

Rajoitukset

  1. 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.

Käyttöoikeustyyppi Lupa Käyttöoikeuden näyttönimi
Sovellus Tapaus.Lue.Kaikki Read all Incidents
Sovellus Incident.ReadWrite.All Read and write all Incidents
Delegoitu (työpaikan tai oppilaitoksen tili) Tapaus.Lue Read Incidents
Delegoitu (työpaikan tai oppilaitoksen tili) Tapaus.Luku Jaettava Read and write Incidents

Huomautus

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

  • Käyttäjällä on oltava vähintään seuraavat roolioikeudet: View Data
  • Vastaus sisältää vain tapaukset, joille käyttäjä altistuu

HTTP-pyyntö

GET .../api/incidents/{id}

Pyynnön otsikot

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

Pyynnön leipäteksti

Tyhjä

Vastaus

Jos tämä menetelmä onnistuu, se palauttaa 200 OK-menetelmän ja tapausentiteetin vastauksen leipätekstissä. Jos määritettyä tunnusta käyttävää tapausta ei löytynyt - 404 Ei löytynyt.

Esimerkki

Pyytää

Tässä on esimerkki pyynnöstä.

GET https://api.security.microsoft.com/api/incidents/{id}

Microsoft Graph -suojauksen ohjelmointirajapinnan käyttäminen – Microsoft Graph | Microsoft Learn

Vihje

Haluatko tietää lisää? Ota yhteyttä Microsoft Security -yhteisöön Tech Community -yhteisössä: Microsoft Defender XDR Tech Community.