Share via


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

  1. Maximal storleksbegränsning för filer är 20 MB.

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

Tips

Vill du veta mer? Engage med Microsofts säkerhetscommunity i vår Tech Community: Microsoft Defender för Endpoint Tech Community.