Metody a vlastnosti rozhraní API pro export podrobností o stavu antivirového softwaru zařízení
Platí pro:
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
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é.
Popis rozhraní API pro export podrobností o stavu antivirového softwaru zařízení
Načte seznam podrobností o stavu zařízení Microsoft Defender Antivirové ochrany. Toto rozhraní API má různá volání (metody) rozhraní API pro získání různých typů dat. Vzhledem k tomu, že množství dat může být velké, můžete je načíst dvěma způsoby:
Odpověď JSON Rozhraní API natáhne všechna data ve vaší organizaci jako odpovědi JSON. Tato metoda je nejvhodnější pro malé organizace s méně než 100 tisíci zařízeními. Odpověď je stránkovaná, takže k načtení dalších výsledků můžete použít pole @odata.nextLink z odpovědi.
prostřednictvím souborů Toto řešení rozhraní API umožňuje rychlejší a spolehlivější načítání větších objemů dat a doporučuje se pro velké organizace, které mají více než 100 000 zařízení. Toto rozhraní API natahuje všechna data ve vaší organizaci jako soubory ke stažení. Odpověď obsahuje adresy URL pro stažení všech dat ze služby Azure Storage. Toto rozhraní API umožňuje stáhnout všechna data ze služby Azure Storage následujícím způsobem:
Voláním rozhraní API získáte seznam adres URL ke stažení se všemi daty vaší organizace.
Stáhněte si všechny soubory pomocí adres URL pro stahování a zpracovávat data podle potřeby.
Data, která se shromažďují pomocí JSON response souborů nebo pomocí souborů, jsou snímkem aktuálního stavu. Tato data neobsahují historická data. Pokud chcete shromažďovat historická data, musíte je uložit do vlastního datového úložiště.
Důležité
Aby se Windows Server 2012 R2 a Windows Server 2016 zobrazovaly v sestavách stavu zařízení, musí být tato zařízení nasazená pomocí moderního balíčku sjednoceného řešení. Další informace najdete v tématu Nové funkce moderního sjednoceného řešení pro Windows Server 2012 R2 a 2016.
Informace o používání nástroje pro generování sestav stavu zařízení a antivirového softwaru na portálu Microsoft Defender najdete v tématu Sestava stavu zařízení a antivirové ochrany v Microsoft Defender for Endpoint.
1.1 Export metod rozhraní API s podrobnostmi o stavu antivirového softwaru
| Metoda | Datový typ | Popis |
|---|---|---|
| (odpověď JSON) | Microsoft Defender stav antivirové ochrany na kolekci zařízení. Viz : 1.2 Export vlastností rozhraní API s podrobnostmi o stavu antivirového softwaru zařízení (odpověď JSON). | Vrátí tabulku s položkou pro každou jedinečnou kombinaci DeviceId a ConfigurationId. Rozhraní API natáhne všechna data ve vaší organizaci jako odpovědi JSON. Tato metoda je nejvhodnější pro malé organizace s méně než 100 tisíci zařízeními. Odpověď je stránkovaná, takže můžete použít @odata.nextLink pole z odpovědi k načtení dalších výsledků. |
| (prostřednictvím souborů) | Microsoft Defender stav antivirové ochrany na kolekci zařízení. Viz : 1.3 Export podrobností o stavu antivirového softwaru zařízení ve vlastnostech rozhraní API (prostřednictvím souborů). | Vrátí tabulku s položkou pro každou jedinečnou kombinaci DeviceId a ConfigurationId. Toto řešení rozhraní API umožňuje rychlejší a spolehlivější načítání větších objemů dat. Proto se doporučuje pro velké organizace s více než 100K zařízeními. Toto rozhraní API natahuje všechna data ve vaší organizaci jako soubory ke stažení. Odpověď obsahuje adresy URL pro stažení všech dat ze služby Azure Storage. Toto rozhraní API umožňuje stáhnout všechna data ze služby Azure Storage následujícím způsobem:
|
1.2 Omezení
- Maximální velikost stránky: 200 000
- Omezení rychlosti pro toto rozhraní API: 30 volání za minutu a 1 000 volání za hodinu
1.3 Export vlastností rozhraní API s podrobnostmi o stavu antivirového softwaru zařízení (odpověď JSON)
- Vlastnosti definované v následující tabulce jsou uvedeny abecedně podle ID vlastnosti. Pokud použijete toto rozhraní API, výsledný výstup se nemusí nutně vrátit ve stejném pořadí uvedeném v této tabulce.
- Mějte na paměti, že rbacgroupname a ID nejsou podporované operátory filtru.
- V odpovědi se můžou vrátit některé další sloupce. Tyto sloupce mohou být dočasné a mohou být odebrány; použít pouze zdokumentované sloupce.
| Vlastnost (ID) | Datový typ | Popis | Příklad vrácené hodnoty |
|---|---|---|---|
avEngineUpdateTime |
DateTimeOffset | Datum a čas poslední aktualizace antivirového modulu na zařízení | "2022-08-04T12:44:02Z" |
avEngineVersion |
String | Verze antivirového modulu | 1.1.19400.3 |
avIsEngineUpToDate |
String | Aktuální stav antivirového modulu |
True, Falsenebo Unknown |
avIsPlatformUpToDate |
String | Aktuální stav antivirové platformy |
True, Falsenebo Unknown |
avIsSignatureUpToDate |
String | Aktuální stav antivirového podpisu |
True, Falsenebo Unknown |
avMode |
String | Antivirový režim. | Každý režim je celočíselná hodnota řetězcového typu od 0 do 5. '' = Other0 = Active1 = Passive2 = Disabled3 = Other4 = EDRBlocked5 = PassiveAudit |
avPlatformUpdateTime |
DateTimeOffset | Datum a čas poslední aktualizace antivirové platformy na zařízení | "2022-08-04T12:44:02Z" |
avPlatformVersion |
String | Verze antivirové platformy | 4.18.2203.5 |
avSignaturePublishTime |
DateTimeOffset | Datum a čas vydání antivirového buildu bezpečnostních informací | "2022-08-04T12:44:02Z" |
avSignatureUpdateTime |
DateTimeOffset | Datum a čas poslední aktualizace antivirových bezpečnostních informací na zařízení | "2022-08-04T12:44:02Z" |
avSignatureVersion |
String | Antivirová verze bezpečnostních informací | 1.371.1323.0 |
computerDnsName |
String | Název DNS | SampleDns |
dataRefreshTimestamp |
DateTimeOffset | Datetime when data is refreshed for this report | 2022-08-04T12:44:02Z |
fullScanError |
String | Kódy chyb z úplného prohledávání | "0x80508023" |
fullScanResult |
String | Úplný výsledek kontroly zařízení |
Completed, Cancelednebo Failed |
fullScanTime |
DateTimeOffset | Datum a čas dokončení úplné kontroly | 2022-08-04T12:44:02Z |
id |
String | Identifikátor GUID počítače | 30a8fa2826abf24d24379b23f8a44d471f00feab |
lastSeenTime |
DateTimeOffset | Datum a čas posledního výskytu tohoto počítače | 2022-08-04T12:44:02Z |
machineId |
String | Identifikátor GUID počítače | 30a8fa2826abf24d24379b23f8a44d471f00feab |
osKind |
String | Druh operačního systému |
windows, macnebo linux |
osPlatform |
String | Název hlavní verze operačního systému |
Windows 10 nebo macOS |
osVersion |
String | Verze operačního systému | 10.0.18363.1440, 12.4.0.0 |
quickScanError |
String | Kódy chyb z rychlé kontroly | 0x80508023 |
quickScanResult |
String | Výsledek rychlé kontroly tohoto zařízení |
Completed, Cancelednebo Failed |
quickScanTime |
DateTimeOffset | Datum a čas po dokončení rychlé kontroly | 2022-08-04T12:44:02Z |
rbacGroupId |
Dlouhý | ID skupiny zařízení, do kterého tento počítač patří | 712 |
rbacGroupName |
String | Název skupiny zařízení, do které tento počítač patří | SampleGroup |
1.4 Export vlastností rozhraní API s podrobnostmi o stavu antivirového softwaru zařízení (prostřednictvím souborů)
Důležité
Informace v této části se týkají předem vydaných produktů, které lze před komerčním vydáním podstatně upravit. Společnost Microsoft neposkytuje v souvislosti se zde uvedenými informacemi žádné výslovné ani předpokládané záruky.
Poznámka
- Soubory jsou komprimované gzipem a ve víceřádkovém
.jsonformátu. - Adresy URL pro stahování jsou platné pouze 3 hodiny. v opačném případě můžete použít parametr .
- Pokud chcete zajistit maximální rychlost stahování dat, můžete se ujistit, že stahujete ze stejné oblasti Azure, ve které se nacházejí vaše data.
- Každý záznam používá přibližně 1 kB dat. Při výběru správného
pageSizeparametru byste to měli vzít v úvahu. - V odpovědi se může vrátit více sloupců. Tyto sloupce jsou dočasné a můžou být odebrány, proto používejte jenom zdokumentované sloupce.
| Vlastnost (ID) | Datový typ | Popis | Příklad vrácené hodnoty |
|---|---|---|---|
| Export souborů | array[string] | Seznam adres URL ke stažení pro soubory, které uchovávají aktuální snímek organizace. | ["https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...1", "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...2"] |
| GeneratedTime | String | Čas vygenerování exportu | 2022-05-20T08:00:00Z |
Poznámka
V každém z exportovaných souborů je vlastnost s názvem DeviceGatheredInfo, která obsahuje antivirová data. Každý z jeho atributů vám může poskytnout informace o stavu zařízení a jeho stavu.
Viz také
Export sestavy stavu antivirové ochrany zařízení
Sestavy stavu zařízení a dodržování předpisů
Tip
Chcete se dozvědět více? Engage s komunitou Microsoft Security v naší technické komunitě: Microsoft Defender for Endpoint Tech Community.