alertRule 资源类型

命名空间：microsoft.graph.deviceManagement

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

表示具有适当角色的 IT 管理员可以配置的规则，以监视 Microsoft Endpoint Manager 管理中心的问题并触发警报。

达到 alertRule 的阈值时，将生成并存储 alertRecord ，并且管理员通过定义的通知通道接收通知。

有关详细信息，请参阅 监视 资源。

注意

此 API 是警报监视 API 集的一部分，目前仅支持Windows 365和云电脑方案。 API 集允许管理员设置规则，以在预配云电脑、上传云电脑映像和检查 Azure 网络连接时发出警报。

是否还有其他方案，可以在 Microsoft Endpoint Manager 管理中心使用其他编程警报支持？ 建议功能或投票支持现有功能请求。

方法	返回类型	说明
列出 alertRules	microsoft.graph.deviceManagement.alertRule 集合	获取 alertRule 对象及其属性的列表。
创建 alertRule	microsoft.graph.deviceManagement.alertRule	创建 alertRule 对象。
获取 alertRule	microsoft.graph.deviceManagement.alertRule	读取 alertRule 对象的属性和关系。
更新 alertRule	microsoft.graph.deviceManagement.alertRule	更新 alertRule 对象的属性。

属性

属性	类型	说明
alertRuleTemplate	microsoft.graph.deviceManagement.alertRuleTemplate	警报事件的规则模板。 可能的值包括 cloudPcProvisionScenario、cloudPcImageUploadScenario、cloudPcOnPremiseNetworkConnectionCheckScenario、cloudPcInGracePeriodScenario、cloudPcFrontlineInsufficientLicensesScenario、cloudPcInaccessibleScenario。 请注意，必须使用 Prefer: include-unknown-enum-members 请求标头从此 可演变枚举中获取以下值： cloudPcInGracePeriodScenario。
说明	String	规则说明。
displayName	String	规则的显示名称。
enabled	布尔值	指示规则是启用还是禁用的规则的状态。 如果 true为 ，则启用规则;否则禁用该规则。
id	String	警报规则的唯一标识符。 继承自 entity。
isSystemRule	布尔值	指示规则是否为系统规则。 如果 true为 ，则规则是系统规则;否则，该规则是自定义的规则，可以编辑。 系统规则是内置的，只能编辑几个属性。
notificationChannels	microsoft.graph.deviceManagement.notificationChannel 集合	用户选择的规则的通知通道。
severity	microsoft.graph.deviceManagement.ruleSeverityType	规则的严重性。 可能的值包括 unknown、informational、warning、critical、unknownFutureValue。
阈 值	microsoft.graph.deviceManagement.ruleThreshold	确定何时发送警报的条件。 例如，可以将条件配置为在六台或更多台云电脑的预配失败时发送警报。 此属性已弃用。 请改用条件。
conditions	microsoft.graph.deviceManagement.ruleCondition 集合	确定何时发送警报的条件。 例如，可以将条件配置为在六台或更多台云电脑的预配失败时发送警报。

alertRuleTemplate 值

成员	说明
cloudPcProvisionScenario	由于云电脑预配出现问题，触发了警报规则。 对于系统规则，针对云电脑预配失败触发了警报规则。
cloudPcImageUploadScenario	由于上传云电脑映像的过程出现问题，触发了警报规则。 对于系统规则，会针对无法上传云电脑映像触发警报规则。
cloudPcOnPremiseNetworkConnectionCheckScenario	由于本地网络连接检查出现问题，触发了警报规则。 对于系统规则，针对本地网络连接失败触发了警报规则。
unknownFutureValue	可演变枚举 sentinel 值。 请勿使用。
cloudPcInGracePeriodScenario	当云电脑进入宽限期时，会触发警报规则。
cloudPcFrontlineInsufficientLicensesScenario	已针对活动云电脑的并发云电脑连接数超过并发限制允许的一线云电脑触发了警报规则。
cloudPcInaccessibleScenario	当云电脑因主机运行状况故障、连接错误或区域中断而无法连接时，会触发警报规则。 或者，因为它们正在预配或还原设备状态。

ruleSeverityType 值

成员	说明
unknown	严重级别为 unknown。 用于初始化。
信息	严重级别为 informational。
警告	严重级别为 warning。
关键	严重级别为 critical。
unknownFutureValue	可演变枚举 sentinel 值。 请勿使用。

关系

无。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "@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"
  },
  "condition": [
    {
      "@odata.type": "microsoft.graph.deviceManagement.ruleCondition"
    }
  ]
}