Share via


Tiedostojen lataaminen reaaliaikaiseen vastauskirjastoon

Koskee seuraavia:

Tärkeää

Jotkin tämän artikkelin tiedot liittyvät tuotteen ennakkojulkaisuversioon, jota voidaan muuttaa huomattavasti ennen kaupallista julkaisua. Microsoft ei anna mitään takuita tässä annettujen tietojen suhteen.

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

Huomautus

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

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

Ohjelmointirajapinnan kuvaus

Lataa tiedosto reaaliaikaiseen vastauskirjastoon.

Rajoitukset

  1. Tiedoston enimmäiskoon rajoitus on 20 Mt.

  2. 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 Aloittaminen.

Käyttöoikeustyyppi Lupaa Käyttöoikeuden näyttönimi
Sovellus Library.Manage Hallitse reaaliaikaista vastauskirjastoa
Delegoitu (työpaikan tai oppilaitoksen tili) Library.Manage Hallitse reaaliaikaista vastauskirjastoa

HTTP-pyyntö

Ladata

POST https://api.security.microsoft.com/api/libraryfiles

Pyynnön otsikot

Nimi Kirjoita Kuvaus
Lupa Merkkijono Haltijatunnus<>. Tarvitaan.
Sisältötyyppi Merkkijono multipart/form-data. Tarvitaan.

Pyynnön leipäteksti

Anna pyynnön runkoon lomaketieto-objekti, jolla on seuraavat parametrit:

Parametri Kirjoita Kuvaus
Tiedosto Tiedoston sisältö Reaaliaikaiseen vastauskirjastoon ladattava tiedosto. Tarvitaan
Kuvaus Merkkijono Tiedoston kuvaus.
ParametersDescription Merkkijono (Valinnainen) Komentosarjan suorittamiseen tarvittavat parametrit. Oletusarvo on tyhjä merkkijono.
OhitaJos Exists Totuusarvo (Valinnainen) Haluatko ohittaa tiedoston, jos se on jo olemassa. Oletusarvo on tyhjä merkkijono.

Vastaus

  • Jos tämä menetelmä onnistuu, se palauttaa arvon 200 – OK-vastauskoodin ja palvelimeen ladatun reaaliaikaisen vastauskirjaston entiteetin vastauksen leipätekstissä.

  • Jos se ei onnistunut: tämä menetelmä palauttaa arvon 400 - Virheellinen pyyntö. Virheellinen pyyntö viittaa yleensä virheelliseen leipätekstiin.

Esimerkki

Pyyntö

Tässä on esimerkki pyynnöstä, jossa käytetään curl-toimintoa.

curl -X POST https://api.security.microsoft.com/api/libraryfiles -H
"Authorization: Bearer \$token" -F "file=\@mdatp1.png" -F
"ParametersDescription=test"
-F "HasParameters=true" -F "OverrideIfExists=true" -F "Description=test
description"

Vihje

Haluatko tietää lisää? Engage Microsoft security -yhteisön kanssa teknologiayhteisössämme: Microsoft Defender for Endpoint Tech Community.