Utilize esta API para tomar medidas especificadas num alerta específico detetado pelo Defender para IoT.
Por exemplo, pode utilizar esta API para criar uma regra de reencaminhamento que reencaminha dados para o QRadar. Para obter mais informações, veja Integrar o Qradar com Microsoft Defender para IoT.
Gere janelas de manutenção, nas quais os alertas não serão enviados. Utilize esta API para definir e atualizar horas de paragem e início, dispositivos ou sub-redes que devem ser excluídos ao acionar alertas ou definir e atualizar motores do Defender para IoT que devem ser excluídos.
Por exemplo, durante uma janela de manutenção, poderá querer parar a entrega de alertas de todos os alertas, exceto alertas de software maligno em dispositivos críticos.
As janelas de manutenção que definem com a maintenanceWindow API aparecem na janela Exclusões de Alertas da consola de gestão no local como uma regra de exclusão só de leitura, com o nome com a seguinte sintaxe: Maintenance-{token name}-{ticket ID}.
Importante
Esta API é suportada apenas para fins de manutenção e por um período de tempo limitado e não se destina a ser utilizada em vez de regras de exclusão de alertas. Utilize esta API apenas para operações de manutenção temporária única.
Cadeia. Define o ID do pedido de manutenção nos sistemas do utilizador. Certifique-se de que o ID da permissão não está ligado a uma janela aberta existente.
2987345p98234
Necessário
ttl
Número inteiro positivo. Define o TTL (time to live), que é a duração da janela de manutenção, em minutos. Após a conclusão do período de tempo definido, a janela de manutenção termina e o sistema comporta-se normalmente novamente.
180
Necessário
motores
Matriz JSON de cadeias. Define o motor a partir do qual suprimir alertas durante a janela de manutenção. Valores possíveis:
Matriz JSON de cadeias. Define os sensores a partir dos quais suprimir alertas durante a janela de manutenção. Pode obter estes IDs de sensor a partir da API de aplicações (Gerir aplicações de sensores OT ).
1,35,63
Opcional
sub-redes
Matriz JSON de cadeias. Define as sub-redes a partir das quais suprimir alertas durante a janela de manutenção. Defina cada sub-rede numa notação CIDR.
192.168.0.0/16,138.136.80.0/14,112.138.10.0/8
Opcional
Código de estado
Mensagem
Descrição
201 (Criado)
-
A ação foi concluída com êxito.
400 (Pedido Incorreto)
Sem TicketId
O pedido da API não tinha um ticketId valor.
400 (Pedido Incorreto)
TTL Ilegal
O pedido da API incluía um valor TTL não positivo ou não numérico.
400 (Pedido Incorreto)
Não foi possível analisar o pedido.
Problema ao analisar o corpo, como parâmetros incorretos ou valores inválidos.
400 (Pedido Incorreto)
A janela de manutenção com os mesmos parâmetros já existe.
Aparece quando já existe uma janela de manutenção existente com os mesmos detalhes.
404 (Não Encontrado)
ID de sensor desconhecido
Um dos sensores listados no pedido não existe.
409 (Conflito)
O ID do Pedido de Suporte já tem uma janela aberta.
O ID da permissão está ligado a outra janela de manutenção aberta.
Obtenha um registo de todas as ações abertas (POST), close (DELETE) e update (PUT) que foram realizadas com esta API para processar janelas de manutenção. T
Filtra os registos a partir da data predefinida e posterior. O formato é YYYY-MM-DD.
2022-08-10
Opcional
toDate
Filtra os registos até à data predefinida. O formato é YYYY-MM-DD.
2022-08-10
Opcional
ticketId
Filtra os registos relacionados com um ID de pedido específico.
9a5fe99c-d914-4bda-9332-307384fe40bf
Opcional
tokenName
Filtra os registos relacionados com um nome de token específico.
quarterly-sanidade-window
Opcional
Códigos de erro:
Código
Mensagem
Descrição
200
OK
A ação foi concluída com êxito.
204:
Sem Conteúdo
Não existem dados para mostrar.
400
Pedido Incorreto
O formato de data está incorreto.
500
Erro de Servidor Interno
Qualquer outro erro inesperado.
Tipo: JSON
Matriz de objetos JSON que representam operações da janela de manutenção.
Estrutura de resposta:
Nome
Tipo
Nulo / Não nulo
Lista de valores
id
Número inteiro longo
Não nulo
Um ID interno para o registo atual
dateTime
String
Não nulo
A hora em que a atividade ocorreu, por exemplo: 2022-04-23T18:25:43.511Z
ticketId
String
Não nulo
O ID da janela de manutenção. Por exemplo: 9a5fe99c-d914-4bda-9332-307384fe40bf
tokenName
String
Não nulo
O nome do token da janela de manutenção. Por exemplo: quarterly-sanity-window
motores
Matriz de cadeias
Pode ser nulo
Os motores nos quais se aplica a janela de manutenção, conforme fornecido durante a criação da janela de manutenção: Protocol Violation, Policy Violation, Malware, Anomalyou Operational
sensorIds
Matriz da cadeia
Pode ser nulo
Os sensores nos quais se aplica a janela de manutenção, conforme fornecido durante a criação da janela de manutenção.
sub-redes
Matriz da cadeia
Pode ser nulo
As sub-redes nas quais se aplica a janela de manutenção, conforme fornecido durante a criação da janela de manutenção.
ttl
Operador numérico
Pode ser nulo
O Time to Live (TTL) da janela de manutenção, conforme fornecido durante a criação ou atualização da janela de manutenção.
Permite-lhe atualizar a duração da janela de manutenção depois de iniciar o processo de manutenção ao alterar o ttl parâmetro. A nova definição de duração substitui a anterior.
Este método é útil quando pretende definir uma duração mais longa do que a duração atualmente configurada. Por exemplo, se tiver definido originalmente 180 minutos, passaram 90 minutos e pretender adicionar mais 30 minutos, atualize o ttl minuto para 120 repor a contagem de duração.