Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Wichtig
Einige Informationen in diesem Artikel beziehen sich auf ein vorab veröffentlichtes Produkt, das vor der kommerziellen Veröffentlichung möglicherweise erheblich geändert wird. Microsoft übernimmt in Bezug auf die hier bereitgestellten Informationen keine Gewährleistung, weder ausdrücklich noch konkludent.
API-Beschreibung
Laden Sie die Datei in die Liveantwortbibliothek hoch.
Tipp
Sie können auch Liveantwortdateien von der Bibliotheksverwaltungsseite im Microsoft Defender-Portal hochladen.
Begrenzungen
- Die maximale Dateigrößenbeschränkung beträgt 20 MB.
- Ratenbeschränkungen für diese API sind 100 Aufrufe pro Minute und 1500 Aufrufe pro Stunde.
Berechtigungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, einschließlich der Auswahl von Berechtigungen, finden Sie unter Erste Schritte.
| Berechtigungstyp | Permission | Anzeigename der Berechtigung |
|---|---|---|
| Application | Library.Manage | Verwalten der Liveantwortbibliothek |
| Delegiert (Geschäfts-, Schul- oder Unikonto) | Library.Manage | Verwalten der Liveantwortbibliothek |
HTTP-Anforderung
Hochladen
POST https://api.security.microsoft.com/api/libraryfiles
Anforderungsheader
| Name | Typ | Beschreibung |
|---|---|---|
| Authorization | Zeichenfolge | Bearertoken<>. Erforderlich. |
| Content-Type | string | multipart/form-data. Erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext ein Formulardatenobjekt mit den folgenden Parametern an:
| Parameter | Typ | Beschreibung |
|---|---|---|
| File | Dateiinhalt | Die Datei, die in die Liveantwortbibliothek hochgeladen werden soll. Erforderlich |
| Beschreibung | Zeichenfolge | Beschreibung der Datei |
| ParametersDescription | Zeichenfolge | (Optional) Parameter, die für die Ausführung des Skripts erforderlich sind. Der Standardwert ist eine leere Zeichenfolge. |
| OverrideIfExists | Boolean | (Optional) Gibt an, ob die Datei überschrieben werden soll, wenn sie bereits vorhanden ist. Der Standardwert ist eine leere Zeichenfolge. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 200 – OK und die hochgeladene Liveantwortbibliotheksentität im Antworttext zurück.
Wenn nicht erfolgreich: Diese Methode gibt 400 – Ungültige Anforderung zurück. Eine fehlerhafte Anforderung weist in der Regel auf einen falschen Text hin.
Beispiel
Anforderung
Hier sehen Sie ein Beispiel für die Anforderung mit 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"