Získání výsledků živé odpovědi

Článek
2025-02-20

Platí pro:

Důležité

Některé informace v tomto článku se týkají předvydaného produktu, který může být před komerčním vydáním podstatně změněn. Společnost Microsoft neposkytuje na zde uvedené informace žádné záruky, vyjádřené ani předpokládané.

Chcete vyzkoušet Defender pro Endpoint? Zaregistrujte se a získejte bezplatnou zkušební verzi,

Poznámka

Pokud jste zákazníkem státní správy USA, použijte identifikátory URI uvedené v Microsoft Defender for Endpoint pro zákazníky státní správy USA.

Tip

Pro lepší výkon můžete použít server blíže k vašemu geografickému umístění:

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

Popis rozhraní API

Načte konkrétní výsledek příkazu živé odpovědi podle svého indexu.

Omezení

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

Minimální požadavky

Než budete moct zahájit relaci na zařízení, ujistěte se, že splňujete následující požadavky:

Ověřte, že používáte podporovanou verzi Windows.

Na zařízeních musí běžet jedna z následujících verzí Windows.
- Windows 11
- Windows 10
  - Verze 1909 nebo novější
  - Verze 1903 s KB4515384
  - Verze 1809 (RS 5) s KB4537818
  - Verze 1803 (RS 4) s KB4537795
  - Verze 1709 (RS 3) s KB4537816
- Windows Server 2019 – platí jenom pro verzi Public Preview
  - Verze 1903 nebo (s KB4515384) novější
  - Verze 1809 (s KB4537818)
- Windows Server 2022
- Windows Server 2025

Oprávnění

K volání tohoto rozhraní API se vyžaduje jedno z následujících oprávnění. Další informace, včetně postupu při výběru oprávnění, najdete v tématu Začínáme.

Typ oprávnění	Povolení	Zobrazovaný název oprávnění
Application	Machine.Read.All	Čtení všech profilů počítačů
Application	Machine.ReadWrite.All	Čtení a zápis všech informací o počítači
Delegovaný (pracovní nebo školní účet)	Machine.LiveResponse	Spuštění živé odpovědi na konkrétním počítači

Požadavek HTTP

GET https://api.securitycenter.microsoft.com/api/machineactions/{machine action
id}/GetLiveResponseResultDownloadLink(index={command-index})

Hlavičky požadavků

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

Text požadavku

Prázdný

Odpověď

Pokud je tato metoda úspěšná, vrátí tato metoda kód odpovědi 200, OK s objektem, který obsahuje odkaz na výsledek příkazu ve vlastnosti value . Tento odkaz je platný 30 minut a měl by se okamžitě použít ke stažení balíčku do místního úložiště. Odkaz, jehož platnost vypršela, je možné znovu vytvořit jiným voláním a není nutné znovu spouštět živou odpověď.

Vlastnosti přepisu runscriptu:

Vlastnost	Popis
script_name	Název spuštěného skriptu
exit_code	Ukončovací kód spuštěného skriptu
script_output	Standardní výstup spuštěného skriptu
script_errors	Standardní výstup chyby spuštěného skriptu

Příklad

Příklad požadavku

Tady je příklad požadavku.

GET https://api.securitycenter.microsoft.com/api/machineactions/988cc94e-7a8f-4b28-ab65-54970c5d5018/GetLiveResponseResultDownloadLink(index=0)

Příklad odpovědi

Tady je příklad odpovědi.

HTTP/1.1 200 Ok

Typ obsahu: application/json

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Edm.String",
    "value": "https://core.windows.net/investigation-actions-data/ID/CustomPlaybookCommandOutput/4ed5e7807ad1fe59b00b664fe06a0f07?se=2021-02-04T16%3A13%3A50Z&sp=r&sv=2019-07-07&sr=b&sig=1dYGe9rPvUlXBPvYSmr6/OLXPY98m8qWqfIQCBbyZTY%3D"
}

Obsah souboru:

{
    "script_name": "minidump.ps1",
    "exit_code": 0,
    "script_output": "Transcript started, output file is C:\\ProgramData\\Microsoft\\Windows Defender Advanced Threat Protection\\Temp\\PSScriptOutputs\\PSScript_Transcript_{TRANSCRIPT_ID}.txt
C:\\windows\\TEMP\\OfficeClickToRun.dmp.zip\n51 MB\n\u0000\u0000\u0000",
    "script_errors":""
}

Tip

Chcete se dozvědět více? Engage s komunitou Microsoft Security v naší technické komunitě: Microsoft Defender for Endpoint Tech Community.

Sdílet prostřednictvím