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
- ina.api.security.microsoft.com
API-beschrijving
Bestand uploaden naar live-antwoordbibliotheek.
Beperkingen
Maximale bestandsgrootte is 20 MB.
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 |
---|---|---|
Machtiging | 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"
Verwant onderwerp
Tip
Wil je meer weten? Neem contact op met de Microsoft Security-community in onze Tech Community: Microsoft Defender for Endpoint Tech Community.