Delen via


Bestanden uploaden naar de live-antwoordbibliotheek

Van toepassing op:

Belangrijk

Sommige informatie in dit artikel heeft betrekking op een vooraf uitgebracht product dat aanzienlijk kan worden gewijzigd voordat het commercieel wordt uitgebracht. Microsoft geeft geen garanties, expliciet of impliciet, met betrekking tot de informatie die hier wordt verstrekt.

Wilt u Microsoft Defender voor Eindpunt ervaren? Meld u aan voor een gratis proefversie.

Opmerking

Als u een klant van de Amerikaanse overheid bent, gebruikt u de URI's die worden vermeld in Microsoft Defender voor Eindpunt voor klanten van de Amerikaanse overheid.

Tip

Voor betere prestaties kunt u de server dichter bij uw geografische locatie gebruiken:

  • 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-beschrijving

Bestand uploaden naar live-antwoordbibliotheek.

Beperkingen

  1. Maximale bestandsgrootte is 20 MB.

  2. Frequentiebeperkingen voor deze API zijn 100 aanroepen per minuut en 1500 aanroepen per uur.

Machtigingen

Een van de volgende machtigingen is vereist om deze API aan te roepen. Zie Aan de slag voor meer informatie, waaronder het kiezen van machtigingen.

Machtigingstype Machtiging Weergavenaam van machtiging
Toepassing Library.Manage Bibliotheek voor liveantwoorden beheren
Gedelegeerd (werk- of schoolaccount) Library.Manage Bibliotheek voor liveantwoorden beheren

HTTP-aanvraag

Uploaden

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

Aanvraagheaders

Naam Type Beschrijving
Vergunning Tekenreeks Bearer-token<>. Vereist.
Content-Type reeks meerdelige/formuliergegevens. Vereist.

Aanvraagtekst

Geef in de aanvraagtekst een formuliergegevensobject op met de volgende parameters:

Parameter Type Beschrijving
Bestand Bestandsinhoud Het bestand dat moet worden geĆ¼pload naar de live-antwoordbibliotheek. Vereist
Beschrijving Tekenreeks Beschrijving van het bestand.
ParametersDescription Tekenreeks (Optioneel) Parameters die vereist zijn voor het uitvoeren van het script. De standaardwaarde is een lege tekenreeks.
OverrideIfExists Booleaanse waarde (Optioneel) Of u het bestand wilt overschrijven als het al bestaat. De standaardwaarde is een lege tekenreeks.

Antwoord

  • Als dit is gelukt, retourneert deze methode de antwoordcode 200 - OK en de geĆ¼ploade live-antwoordbibliotheekentiteit in de antwoordtekst.

  • Als dit niet lukt: deze methode retourneert 400 - Ongeldige aanvraag. Ongeldige aanvraag geeft meestal een onjuiste hoofdtekst aan.

Voorbeeld

Verzoek

Hier volgt een voorbeeld van de aanvraag met behulp van 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"

Tip

Wil je meer weten? Engage met de Microsoft Security-community in onze Tech Community: Microsoft Defender voor Eindpunt Tech Community.