MachineAction-API abrufen

  • Gilt für:: Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2

API-Beschreibung

Ruft eine bestimmte Computeraktion anhand ihrer ID ab.

Begrenzungen

  • Ratenbeschränkungen für diese API sind 100 Aufrufe pro Minute und 1500 Aufrufe pro Stunde.

Berechtigungen

Beim Abrufen eines Tokens mit Benutzeranmeldeinformationen:

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, einschließlich der Auswahl von Berechtigungen, finden Sie unter Verwenden von Defender für Endpunkt-APIs.

Berechtigungstyp Permission Anzeigename der Berechtigung
Application Machine.ReadWrite.All "Alle Computerinformationen lesen und schreiben"
Delegiert (Geschäfts-, Schul- oder Unikonto) Machine.ReadWrite Lesen und Schreiben von Computerinformationen

HTTP-Anforderung

GET https://api.security.microsoft.com/api/machineactions/{id}

Anforderungsheader

Name Typ Beschreibung
Authorization Zeichenfolge Bearer {token}. Erforderlich.

Anforderungstext

Empty

Antwort

Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 200, OK mit einer Machine Action-Entität zurück. Wenn die Computeraktionsentität mit der angegebenen ID nicht gefunden wurde: 404 Nicht gefunden.

Beispiel

Beispielanforderung

Hier sehen Sie ein Beispiel für die Anforderung.

GET https://api.security.microsoft.com/api/machineactions/aaaabbbb-0000-cccc-1111-dddd2222eeee

Anforderungsbeispiel

Hier ist ein Beispiel für die Antwort.

HTTP/1.1 200 Ok
Content-type: application/json
{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#MachineActions/$entity",
    "id": "5382f7ea-7557-4ab7-9782-d50480024a4e",
    "type": "Isolate",
    "scope": "Selective",
    "requestor": "Analyst@TestPrd.onmicrosoft.com",
    "requestorComment": "test for docs",
    "status": "Succeeded",
    "machineId": "7b1f4967d9728e5aa3c06a9e617a22a4a5a17378",
    "computerDnsName": "desktop-test",
    "creationDateTimeUtc": "2019-01-02T14:39:38.2262283Z",
    "lastUpdateDateTimeUtc": "2019-01-02T14:40:44.6596267Z",
    "relatedFileInfo": null
}
  • Last updated on