Compartilhar via

tipo de recurso alertRule

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, cloudPcImageUploadScenario, cloudPcOnPremiseNetworkConnectionCheckScenario, unknownFutureValue, cloudPcInGracePeriodScenario, cloudPcFrontlineInsufficientLicensesScenario, cloudPcInaccessibleScenario, cloudPcFrontlineConcurrencyScenario, cloudPcUserSettingsPersistenceScenario, cloudPcDeprovisionFailedScenario. Utilize o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração evoluível: cloudPcInGracePeriodScenario, cloudPcFrontlineInsufficientLicensesScenario, cloudPcInaccessibleScenario, cloudPcFrontlineConcurrencyScenario, cloudPcUserSettingsPersistenceScenario, . cloudPcDeprovisionFailedScenario
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.
cloudPcUserSettingsPersistenceScenario Indica que a regra de alerta está associada a um cenário de armazenamento de sincronização de experiência de utilizador do Cloud PC na Linha da Frente em que a utilização atingiu limites ou limiares definidos.
cloudPcDeprovisionFailedScenario Indica que a regra de alerta foi acionada quando um PC na Cloud entrou num processo de desaprovisionamento falhado.

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"
    }
  ]
}
  • Last updated on