Bestanden uploaden naar de live-antwoordbibliotheek

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.

API-beschrijving

Bestand uploaden naar live-antwoordbibliotheek.

Tip

U kunt ook live-antwoordbestanden uploaden vanaf de pagina Bibliotheekbeheer in de Microsoft Defender-portal.

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
Vergunning Tekenreeks Bearer-token<>. Vereist.
Content-Type tekenreeks 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"