Ladda upp filer till live-svarsbiblioteket
Gäller för:
Viktigt
Viss information i den här artikeln gäller en förhyrd produkt som kan ändras avsevärt innan den släpps kommersiellt. Microsoft lämnar inga garantier, uttryckta eller underförstådda, med avseende på den information som tillhandahålls här.
Vill du uppleva Microsoft Defender för Endpoint? Registrera dig för en kostnadsfri utvärderingsversion.
Obs!
Om du är en us government-kund använder du de URI:er som anges i Microsoft Defender för Endpoint för amerikanska myndighetskunder.
Tips
För bättre prestanda kan du använda servern närmare din geoplats:
- 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
API-beskrivning
Ladda upp filen till live-svarsbiblioteket.
Begränsningar
Maximal storleksbegränsning för filer är 20 MB.
Hastighetsbegränsningar för det här API:et är 100 anrop per minut och 1 500 anrop per timme.
Behörigheter
En av följande behörigheter krävs för att anropa det här API:et. Mer information, inklusive hur du väljer behörigheter, finns i Kom igång.
Behörighetstyp | Behörighet | Visningsnamn för behörighet |
---|---|---|
Program | Library.Manage | Hantera live-svarsbibliotek |
Delegerat (arbets- eller skolkonto) | Library.Manage | Hantera live-svarsbibliotek |
HTTP-begäran
Uppladdning
POST https://api.security.microsoft.com/api/libraryfiles
Frågerubriker
Namn | Typ | Beskrivning |
---|---|---|
Tillstånd | Sträng | <Ägartoken>. Obligatoriskt. |
Content-Type | sträng | multipart/form-data. Obligatoriskt. |
Frågebrödtext
I begärandetexten anger du ett formulärdataobjekt med följande parametrar:
Parameter | Typ | Beskrivning |
---|---|---|
Fil | Filinnehåll | Filen som ska laddas upp till live-svarsbiblioteket. Krävs |
Beskrivning | Sträng | Beskrivning av filen. |
ParametersDescription | Sträng | (Valfritt) Parametrar som krävs för att skriptet ska köras. Standardvärdet är en tom sträng. |
OverrideIfExists | Boolesk | (Valfritt) Om filen ska åsidosättas om den redan finns. Standardvärdet är en tom sträng. |
Svar
Om det lyckas returnerar den här metoden 200 – OK-svarskod och den uppladdade live-svarsbiblioteksentiteten i svarstexten.
Om det inte lyckas returnerar den här metoden 400 – felaktig begäran. Felaktig begäran indikerar vanligtvis felaktig brödtext.
Exempel
Begäran
Här är ett exempel på begäran med curl.
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"
Relaterat ämne
Tips
Vill du veta mer? Engage med Microsofts säkerhetscommunity i vår Tech Community: Microsoft Defender för Endpoint Tech Community.
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för