Exportar os detalhes de estado de funcionamento do antivírus do dispositivo métodos e propriedades da API

Descrição da API de detalhes do estado de funcionamento do antivírus do dispositivo

Obtém uma lista de Microsoft Defender detalhes do estado de funcionamento do dispositivo antivírus. Esta API tem diferentes chamadas à API (métodos) para obter diferentes tipos de dados. Uma vez que a quantidade de dados pode ser grande, existem duas formas de os obter:

• JSON A API extrai todos os dados na sua organização como respostas JSON. Este método é melhor para pequenas organizações com menos de 100 K dispositivos. A resposta é paginada, pelo que pode utilizar o campo @odata.nextLink da resposta para obter os resultados seguintes.

• Ficheiros Esta solução de API permite extrair grandes quantidades de dados de forma mais rápida e fiável, e é recomendada para grandes organizações que tenham mais de 100 000 dispositivos. Esta API extrai todos os dados na sua organização como ficheiros de transferência. A resposta contém URLs para transferir todos os dados do Armazenamento Azure. Esta API permite-lhe transferir todos os seus dados do Armazenamento Azure da seguinte forma:

  1. Chame a API para obter uma lista de URLs de transferência com todos os dados da sua organização.

  2. Transfira todos os ficheiros com os URLs de transferência e processe os dados conforme quiser.

Os dados recolhidos através de ou JSON response através de ficheiros são um instantâneo do estado atual. Estes dados não contêm dados históricos. Para recolher dados históricos, tem de guardar os dados no seu próprio armazenamento de dados.

Para obter informações sobre como utilizar a ferramenta de relatórios de conformidade do estado de funcionamento e do antivírus do dispositivo no portal do Microsoft Defender, consulte: Relatório de estado de funcionamento e antivírus do dispositivo no Microsoft Defender para Endpoint.

Pré-requisitos

• Para que Windows Server 2012 R2 e Windows Server 2016 apareçam nos relatórios de estado de funcionamento do dispositivo, estes dispositivos têm de ser integrados com o pacote de solução unificado moderno. Para obter mais informações, veja New functionality in the modern unified solution for Windows Server 2012 R2 and 2016 (Novas funcionalidades na solução unificada moderna para Windows Server 2012 R2 e 2016).

1.1 Exportar métodos de API de detalhes do estado de funcionamento do antivírus do dispositivo

1.2 Limitações

• Tamanho máximo da página: 200 000
• Limitações de taxa para esta API: 30 chamadas por minuto e 1000 chamadas por hora

1.3 Exportar propriedades da API de detalhes de estado de funcionamento do dispositivo (resposta JSON)

• As propriedades definidas na tabela seguinte são listadas alfabeticamente, por ID de propriedade. Quando utiliza esta API, o resultado resultante não será necessariamente devolvido pela mesma ordem listada nesta tabela.
• Tenha em atenção que o rbacgroupname e o ID não são operadores de filtro suportados.
• Poderão ser devolvidas mais algumas colunas na resposta. Estas colunas podem ser temporárias e podem ser removidas; utilize apenas as colunas documentadas.

1.4 Exportar propriedades da API de detalhes do estado de funcionamento do antivírus do dispositivo (através de ficheiros)

Em cada um dos ficheiros de exportação, existe uma propriedade chamada DeviceGatheredInfo, que contém dados antivírus. Cada um dos seus atributos pode fornecer-lhe informações sobre o estado de funcionamento do dispositivo e o respetivo estado.

• Os ficheiros são comprimidos por gzip e em formato multiline .json .
• Os URLs de transferência só são válidos durante 3 horas; caso contrário, pode utilizar o parâmetro .
• Para obter a velocidade máxima de transferência dos seus dados, pode certificar-se de que está a transferir a partir da mesma região Azure onde residem os seus dados.
• Cada registo utiliza aproximadamente 1 KB de dados. Deve ter isto em conta ao escolher o parâmetro correto pageSize .
• Poderão ser devolvidas mais colunas na resposta. Estas colunas são temporárias e podem ser removidas, pelo que utilize apenas as colunas documentadas.