Získání rozhraní API pro machineAction

Popis rozhraní API

Načte konkrétní akci počítače podle svého ID.

Omezení

• Omezení rychlosti pro toto rozhraní API jsou 100 volání za minutu a 1500 volání za hodinu.

Oprávnění

Při získávání tokenu pomocí přihlašovacích údajů uživatele:

• Uživatel musí mít alespoň následující oprávnění role: Zobrazit data. Další informace najdete v tématu Vytváření a správa rolí.

K volání tohoto rozhraní API se vyžaduje jedno z následujících oprávnění. Další informace, včetně postupu výběru oprávnění, najdete v tématu Použití rozhraní DEFENDER for Endpoint API.

Typ oprávnění	Povolení	Zobrazovaný název oprávnění
Application	Machine.ReadWrite.All	Čtení a zápis všech informací o počítači
Delegovaný (pracovní nebo školní účet)	Machine.ReadWrite	Čtení a zápis informací o počítači

Požadavek HTTP

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

Hlavičky požadavků

Name (Název)	Typ	Popis
Oprávnění	String	Nosný {token}. Povinné.

Text požadavku

Prázdný

Odpověď

V případě úspěchu vrátí tato metoda kód odpovědi 200, OK s entitou akce počítače . Pokud se entita akce počítače se zadaným ID nenašla – 404 Nenalezena.

Příklad

Příklad požadavku

Tady je příklad požadavku.

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

Příklad odpovědi

Tady je příklad odpovědi.

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
}