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 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
Lataa tiedosto reaaliaikaiseen vastauskirjastoon.
Rajoitukset
Tiedoston enimmäiskoon rajoitus on 20 Mt.
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 | Lupa | 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ö
Lähettää tiedosto
POST https://api.security.microsoft.com/api/libraryfiles
Pyynnön otsikot
| Nimi | Kirjoita | Kuvaus |
|---|---|---|
| Lupa | Merkkijono | Haltijatunnus<>. Pakollinen. |
| Sisältötyyppi | merkkijono | multipart/form-data. Pakollinen. |
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. Pakollinen |
| 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
Pyytää
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"
Aiheeseen liittyvä aihe
Vihje
Haluatko tietää lisää? Ole yhteydessä Microsoft Security -yhteisöön teknologiayhteisössämme: Microsoft Defender for Endpoint Tech -yhteisössä.