tipo de recurso alertRule

Artigo
12/25/2024

Espaço de nomes: microsoft.graph.deviceManagement

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 que um administrador de TI com as funções adequadas pode configurar para monitorizar problemas e acionar alertas no centro de administração do Microsoft Endpoint Manager.

Quando o limiar de um alertRule é atingido, é gerado e armazenado um alertaRegisto e os administradores recebem notificações através de canais de notificação definidos.

Para obter mais informações, veja o recurso de monitorização .

Observação

Esta API faz parte do conjunto de API de monitorização de alertas que atualmente suporta apenas cenários de Windows 365 e do Cloud PC. O conjunto de API permite que os administradores configurem regras para alertar problemas com o aprovisionamento de PCs na Cloud, carregar imagens do CLOUD PC e verificar as ligações de rede do Azure.

Tem um cenário diferente que pode utilizar suporte de alerta programático adicional no centro de administração do Microsoft Endpoint Manager? Sugira a funcionalidade ou vote nos pedidos de funcionalidade existentes.

Método	Tipo de retorno	Descrição
Listar alertRules	coleção microsoft.graph.deviceManagement.alertRule	Obtenha uma lista dos objetos alertRule e respetivas propriedades.
Criar alertRule	microsoft.graph.deviceManagement.alertRule	Criar um objeto alertRule .
Obter alertRule	microsoft.graph.deviceManagement.alertRule	Leia as propriedades e relações de um objeto alertRule .
Atualizar alertRule	microsoft.graph.deviceManagement.alertRule	Atualize as propriedades de um objeto alertRule .

Propriedades

Propriedade	Tipo	Descrição
alertRuleTemplate	microsoft.graph.deviceManagement.alertRuleTemplate	O modelo de regra do evento de alerta. Os valores possíveis são: `cloudPcProvisionScenario`, , `cloudPcOnPremiseNetworkConnectionCheckScenariocloudPcImageUploadScenario`, `unknownFutureValue`, `cloudPcInGracePeriodScenario`, `cloudPcFrontlineInsufficientLicensesScenario`, `cloudPcInaccessibleScenario`e `cloudPcFrontlineConcurrencyScenario`. Tenha em atenção que tem de utilizar o cabeçalho do `Prefer: include-unknown-enum-members` pedido para obter os seguintes valores desta enumeração evoluível: `cloudPcInGracePeriodScenario`, `cloudPcFrontlineInsufficientLicensesScenario`, `cloudPcInaccessibleScenario`e `cloudPcFrontlineConcurrencyScenario`.
description	Cadeia de caracteres	A descrição da regra.
displayName	Cadeia de caracteres	O nome de exibição da regra.
habilitadas	Booliano	A status da regra que indica se a regra está ativada ou desativada. Se `true`, a regra estiver ativada; caso contrário, a regra será desativada.
id	Cadeia de caracteres	O identificador exclusivo da regra de alerta. Herdado da entidade.
isSystemRule	Booliano	Indica se a regra é uma regra de sistema. Se `true`, a regra for uma regra de sistema; caso contrário, a regra é uma regra definida por personalizado e pode ser editada. As regras de sistema estão incorporadas e apenas algumas propriedades podem ser editadas.
notificationChannels	coleção microsoft.graph.deviceManagement.notificationChannel	Os canais de notificação da regra selecionada pelo utilizador.
severity	microsoft.graph.deviceManagement.ruleSeverityType	A gravidade da regra. Os valores possíveis são: `unknown`, `informational`, `warning`, `critical`, `unknownFutureValue`.
limiar	microsoft.graph.deviceManagement.ruleThreshold	As condições que determinam quando enviar alertas. Por exemplo, pode configurar uma condição para enviar um alerta quando o aprovisionamento falha para seis ou mais PCs na Cloud. Esta propriedade foi preterida. Em alternativa, utilize as condições.
conditions	microsoft.graph.deviceManagement.ruleCondition collection	As condições que determinam quando enviar alertas. Por exemplo, pode configurar uma condição para enviar um alerta quando o aprovisionamento falha para seis ou mais PCs na Cloud.

valores alertRuleTemplate

Member	Descrição
cloudPcProvisionScenario	A regra de alerta foi acionada para um problema com o aprovisionamento do CLOUD PC. Para uma regra de sistema, a regra de alerta foi acionada para uma falha de aprovisionamento do PC na Cloud.
cloudPcImageUploadScenario	A regra de alerta foi acionada para um problema com o processo para carregar a imagem do CLOUD PC. Para uma regra de sistema, a regra de alerta foi acionada para uma falha ao carregar a imagem do PC na Cloud.
cloudPcOnPremiseNetworkConnectionCheckScenario	A regra de alerta foi acionada para um problema com a ligação de rede no local marcar. Para uma regra de sistema, a regra de alerta foi acionada para uma falha com a ligação de rede no local.
unknownFutureValue	Valor da sentinela de enumeração evoluível. Não usar.
cloudPcInGracePeriodScenario	A regra de alerta foi acionada quando o PC na Cloud entrou no período de tolerância.
cloudPcFrontlineInsufficientLicensesScenario	A regra de alerta foi acionada para os PCs na Cloud de Primeira Linha onde estavam ativas mais ligações simultâneas do PC cloud do que o limite de simultaneidade permite.
cloudPcInaccessibleScenario	A regra de alerta foi acionada quando os PCs na Cloud não conseguiram ligar devido a uma falha do estado de funcionamento do anfitrião, erros de ligação ou uma falha de zona. Em alternativa, porque estavam a aprovisionar ou a restaurar status do dispositivo.
cloudPcFrontlineConcurrencyScenario	Indica que a regra de alerta foi acionada para todas as condições da utilização de simultaneidade dos PCs na Cloud de Primeira Linha. Inclui condições de utilização da memória intermédia por enquanto.

ruleSeverityType valores

Member	Descrição
desconhecido	O nível de gravidade é `unknown`. Utilizado para inicialização.
informativo	O nível de gravidade é `informational`.
warning	O nível de gravidade é `warning`.
crítico	O nível de gravidade é `critical`.
unknownFutureValue	Valor da sentinela de enumeração evoluível. Não usar.

Relações

Nenhum

Representação JSON

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

{
  "@odata.type": "#microsoft.graph.deviceManagement.alertRule",
  "alertRuleTemplate": "String",  
  "description": "String",
  "displayName": "String",
  "enabled": "Boolean",
  "id": "String (identifier)",
  "isSystemRule": "Boolean",
  "notificationChannels": [
    {
      "@odata.type": "microsoft.graph.deviceManagement.notificationChannel"
    }
  ], 
  "severity": "String",
  "threshold": {
    "@odata.type": "microsoft.graph.deviceManagement.ruleThreshold"
  },
  "conditions": [
    {
      "@odata.type": "microsoft.graph.deviceManagement.ruleCondition"
    }
  ]
}

Compartilhar via