detectionRule resource type (Tipo de recurso detectionRule)

Espaço de nomes: microsoft.graph.security

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Representa uma regra de deteção personalizada escrita em Investigação avançada para reconhecer automaticamente eventos de segurança quando ocorrem e para acionar alertas e ações de resposta.

As regras de deteção personalizadas permitem-lhe monitorizar proativamente vários eventos e estados do sistema através de consultas de investigação avançadas , incluindo atividades suspeitas de violação e pontos finais configurados incorretamente. Uma regra de deteção personalizada reconhece automaticamente eventos de segurança quando ocorrem e aciona alertas e ações de resposta. Pode definir as regras a executar em intervalos regulares, gerando alertas e efetuando ações de resposta sempre que ocorrem correspondências.

Herda de entidade.

Methods

Método Tipo de retorno Descrição
List coleção microsoft.graph.security.detectionRule Obtenha uma lista dos objetos detectionRule e respetivas propriedades.
Create microsoft.graph.security.detectionRule Crie um novo objeto detectionRule .
Get microsoft.graph.security.detectionRule Leia as propriedades e relações de um objeto detectionRule .
Atualizar microsoft.graph.security.detectionRule Atualize as propriedades de um objeto detectionRule .
Delete Nenhum Eliminar um objeto detectionRule .

Propriedades

Propriedade Tipo Descrição
createdBy Cadeia de caracteres Nome do utilizador ou aplicação que criou a regra. Somente leitura. Suporta $filter (eq, ne, not, in, startsWith, endsWith, contains).
createdDateTime DateTimeOffset Carimbo de data/hora da criação de regras. Somente leitura. $filter Suporta (eq, ne, not, le, ge, lt, gt) e $orderby.
description Cadeia de caracteres Uma descrição fornecida pelo utilizador da regra de deteção. Suporta $filter (eq, ne, not, in, startsWith, endsWith, contains).
displayName Cadeia de caracteres O nome de exibição da regra. $filter Suporta (eq, ne, not, in, startsWith, endsWith, contains) e $orderby.
id Cadeia de caracteres Identificador exclusivo da regra. Herdado da entidade. $filter Suporta (eq, ne, , notin) e $orderby.
lastModifiedBy Cadeia de caracteres Nome do utilizador ou aplicação que atualizou a regra pela última vez. Somente leitura. Suporta $filter (eq, ne, not, in, startsWith, endsWith, contains).
lastModifiedDateTime DateTimeOffset Carimbo de data/hora de quando a regra foi atualizada pela última vez. Somente leitura. $filter Suporta (eq, ne, not, le, ge, lt, gt) e $orderby.
queryCondition microsoft.graph.security.queryCondition A consulta de investigação avançada que define a lógica de deteção desta regra. $filter Suporta em queryCondition/queryText (String) com eq, , nenot, in, startsWith, endsWith, . contains
Cronograma microsoft.graph.security.ruleSchedule A agenda de acionamento desta regra. $filter Suporta a agenda/frequência (Duração) com eq, ne, not, le, , ge, lt, . gt $orderby Suporta em agenda/frequência e agenda/nextRunDateTime.
status microsoft.graph.security.detectionRuleStatus A execução atual status da regra. Os valores possíveis são: enabled, disabled, autoDisabled, unknownFutureValue. $filter Suporta (eq, ne, , notin) e $orderby.
detectorId (preterido) Cadeia de caracteres Identificador interno do detetor. Depreciado. Esta propriedade será removida deste recurso em 2026-10-01.
isEnabled (preterido) Booliano Indica se a regra está ativada para o inquilino. Suporta $filter (eq, ne, not). Depreciado. Em alternativa, utilize status. Esta propriedade será removida deste recurso em 2026-10-01.
detectionAction microsoft.graph.security.detectionAction As ações executadas quando uma deteção é efetuada por esta regra, incluindo o alerta que é criado e quaisquer ações de resposta automatizadas. Suporta as seguintes propriedades $filterde alertTemplate aninhadas:
  • Cadeia: detectionAction/alertTemplate/title, detectionAction/alertTemplate/description, detectionAction/alertTemplate/category, detectionAction/alertTemplate/recommendedActions — cada um suporta eq, ne, , innot, startsWith, , endsWith. contains
  • Enumeração: detectionAction/alertTemplate/severity — suporta eq, ne, not, in.
    		•
    lastRunDetails (preterido) microsoft.graph.security.runDetails Detalhes de execução do runtime para a execução de regras mais recente. $filter Suporta as seguintes propriedades aninhadas:
  • Cadeia: lastRunDetails/failureReason — suporta eq, ne, , notin, startsWith, , endsWith. contains
  • DateTimeOffset: lastRunDetails/lastRunDateTime — suporta eq, , nenot, le, ge, lt. gt
  • Enumeração: lastRunDetails/status, lastRunDetails/errorCode — cada um suporta eq, , ne, not. in
    • Depreciado. Esta propriedade será removida deste recurso em 2026-10-01. Os detalhes de execução do runtime não são expostos na API v1.0.

    Relações

    Nenhum

    Representação JSON

    A representação JSON seguinte mostra o tipo de recurso.

    {
  "@odata.type": "#microsoft.graph.security.detectionRule",
  "id": "String (identifier)",
  "displayName": "String",
  "description": "String",
  "status": "String",
  "createdBy": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedBy": "String",
  "lastModifiedDateTime": "String (timestamp)",
  "queryCondition": {
    "@odata.type": "microsoft.graph.security.queryCondition"
  },
  "schedule": {
    "@odata.type": "microsoft.graph.security.ruleSchedule"
  },
  "detectionAction": {
    "@odata.type": "microsoft.graph.security.detectionAction"
  },
  "detectorId": "String",
  "isEnabled": "Boolean",
  "lastRunDetails": {
    "@odata.type": "microsoft.graph.security.runDetails"
  }
}
    • Last updated on