tipo de recurso alertRecord

Artigo
07/22/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 o registo de um evento de alerta no centro de administração do Microsoft Endpoint Manager acionado por um alertRule.

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 suporta atualmente apenas cenários do 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étodos

Método	Tipo de retorno	Descrição
List	microsoft.graph.deviceManagement.alertRecord collection	Obtenha uma lista dos objetos alertRecord e respetivas propriedades.
Get	microsoft.graph.deviceManagement.alertRecord	Leia as propriedades e relações de um objeto alertRecord .
Obter notificações do portal	coleção microsoft.graph.deviceManagement.portalNotification	Obtenha uma lista de todas as notificações do portal às quais um ou mais utilizadores podem aceder a partir do centro de administração do Microsoft Endpoint Manager.
Definir a notificação do portal como enviada	Nenhum	Defina o estado da notificação especificada no centro de administração do Microsoft EndPoint Manager, conforme enviado.

Propriedades

Propriedade	Tipo	Descrição
alertImpact	microsoft.graph.deviceManagement.alertImpact	O impacto do evento de alerta. Consiste numa lista de par chave-valor e um número seguido do tipo de agregação. Por exemplo, `6 affectedCloudPcCount` significa que 6 PCs na Cloud são afetados. `12 affectedCloudPcPercentage` significa que 12% dos PCs na Cloud são afetados. A lista de pares chave-valor indica os detalhes do impacto do alerta.
alertRuleId	Cadeia de caracteres	O ID correspondente da regra de alerta.
alertRuleTemplate	microsoft.graph.deviceManagement.alertRuleTemplate	O modelo de regra do evento de alerta. Os valores possíveis são: `cloudPcProvisionScenario`, `cloudPcImageUploadScenario`, `cloudPcOnPremiseNetworkConnectionCheckScenario`, `unknownFutureValue`, `cloudPcInGracePeriodScenario`. 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`.
detectedDateTime	DateTimeOffset	A data e hora em que o evento de alerta foi detetado. O tipo carimbo de data/hora representa informações de data e hora com o formato ISO 8601. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é `2014-01-01T00:00:00Z`.
displayName	Cadeia de caracteres	O nome a apresentar do registo de alerta.
id	Cadeia de caracteres	O identificador exclusivo do registo de alerta. Herdado da entidade.
lastUpdatedDateTime	DateTimeOffset	A data e hora em que o registo de alerta foi atualizado pela última vez. O tipo carimbo de data/hora representa informações de data e hora com o formato ISO 8601. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é `2014-01-01T00:00:00Z`.
resolvedDateTime	DateTimeOffset	A data e hora em que o evento de alerta foi resolvido. O tipo carimbo de data/hora representa informações de data e hora com o formato ISO 8601. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é `2014-01-01T00:00:00Z`.
severity	microsoft.graph.deviceManagement.ruleSeverityType	A gravidade do evento de alerta. Os valores possíveis são: `unknown`, `informational`, `warning`, `critical`, `unknownFutureValue`.
status	microsoft.graph.deviceManagement.alertStatusType	O estado do registo de alerta. Os valores possíveis são: `active`, `resolved`, `unknownFutureValue`.

valores alertStatusType

Member	Descrição
ativo	O alerta está ativo.
resolvido	O alerta está marcado como resolvido.
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.alertRecord",
  "alertImpact": {
    "@odata.type": "microsoft.graph.deviceManagement.alertImpact"
  },  
  "alertRuleId": "String",
  "alertRuleTemplate": "String",
  "detectedDateTime": "String (timestamp)",
  "displayName": "String",
  "id": "String (identifier)",
  "lastUpdatedDateTime": "String (timestamp)",
  "resolvedDateTime": "String (timestamp)",
  "severity": "String",
  "status": "String"
}

Compartilhar via