alertRecord リソースの種類

[アーティクル]
07/23/2024

名前空間: microsoft.graph.deviceManagement

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

alertRule によってトリガーされる Microsoft エンドポイントマネージャー管理センターのアラートイベントのレコードを表します。

alertRule のしきい値に達すると、alertRecord が生成されて格納され、管理者は定義済みの通知チャネルを介して通知を受け取ります。

詳細については、監視リソースに関するページを参照してください。

注:

この API は、現在 Windows 365 とクラウド PC のシナリオのみをサポートしているアラート監視 API セットの一部です。 API セットを使用すると、管理者は、クラウド PC のプロビジョニング、クラウド PC イメージのアップロード、Azure ネットワーク接続の確認に関する問題を警告するルールを設定できます。

Microsoft エンドポイントマネージャー管理センターでプログラムによる追加のアラートサポートを使用できる別のシナリオがありますか? 機能を提案するか、既存の機能要求に投票します。

メソッド

メソッド	戻り値の種類	説明
List	microsoft.graph.deviceManagement.alertRecord コレクション	alertRecord オブジェクトとそのプロパティの一覧を取得します。
Get	microsoft.graph.deviceManagement.alertRecord	alertRecord オブジェクトのプロパティとリレーションシップを読み取ります。
ポータル通知を取得する	microsoft.graph.deviceManagement.portalNotification コレクション	Microsoft Endpoint Manager 管理センターから、1 人以上のユーザーがアクセスできるすべてのポータル通知の一覧を取得します。
ポータル通知を送信済みとして設定する	なし	Microsoft EndPoint Manager 管理センターで、指定した通知の状態を送信済みとして設定します。

プロパティ

プロパティ	型	説明
alertImpact	microsoft.graph.deviceManagement.alertImpact	アラートイベントの影響。キーと値のペアの一覧と、集計の種類に続く数値で構成されます。たとえば、 `6 affectedCloudPcCount` は、6 台のクラウド PC が影響を受けるということです。 `12 affectedCloudPcPercentage` は、クラウド PC の 12% が影響を受けるということです。キーと値のペアの一覧は、アラートの影響の詳細を示します。
alertRuleId	String	アラートルールの対応する ID。
alertRuleTemplate	microsoft.graph.deviceManagement.alertRuleTemplate	アラートイベントのルールテンプレート。使用可能な値: `cloudPcProvisionScenario`、`cloudPcImageUploadScenario`、`cloudPcOnPremiseNetworkConnectionCheckScenario`、`unknownFutureValue`、`cloudPcInGracePeriodScenario`。この進化可能な列挙型から次の値を取得するには、`Prefer: include-unknown-enum-members`要求ヘッダーを使用する必要があることに注意してください: `cloudPcInGracePeriodScenario`。
detectedDateTime	DateTimeOffset	アラートイベントが検出された日時。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表します。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、`2014-01-01T00:00:00Z` です。
displayName	String	アラートレコードの表示名。
id	String	アラートレコードの一意識別子。エンティティから継承されます。
lastUpdatedDateTime	DateTimeOffset	アラートレコードが最後に更新された日時。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表します。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、`2014-01-01T00:00:00Z` です。
resolvedDateTime	DateTimeOffset	アラートイベントが解決された日時。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表します。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、`2014-01-01T00:00:00Z` です。
severity	microsoft.graph.deviceManagement.ruleSeverityType	アラートイベントの重大度。使用可能な値: `unknown`、`informational`、`warning`、`critical`、`unknownFutureValue`。
status	microsoft.graph.deviceManagement.alertStatusType	アラートレコードの状態。使用可能な値: `active`、`resolved`、`unknownFutureValue`。

alertStatusType 値

メンバー	説明
アクティブ	アラートがアクティブです。
解決済み	アラートは解決済みとしてマークされます。
unknownFutureValue	進化可能な列挙センチネル値。使用しないでください。

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "@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"
}

次の方法で共有