alert リソースの種類 (非推奨)

名前空間: microsoft.graph

重要

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

注:

従来のアラート API は非推奨となり、2026 年 4 月までに削除される予定です。 新しい アラートとインシデント API に移行することをお勧めします。

このリソースは、Microsoft Graph セキュリティ API の第 1 世代のアラートに対応し、Microsoft またはパートナーのセキュリティ ソリューションによって識別される顧客のテナント内の潜在的なセキュリティの問題を表します。

この種類のアラートは、「 Microsoft Graph セキュリティ API を使用する」に記載されている、サポートされている Azure および Microsoft 365 Defender セキュリティ プロバイダーの呼び出しをフェデレーションします。 さまざまなドメイン間の一般的なアラート データを集計して、アプリケーションが統合されたすべての統合ソリューションでセキュリティの問題の管理を統合および合理化できるようにします。

詳細については、Graph エクスプローラーのサンプル クエリを参照してください。

注:

このリソースは、Microsoft Graph セキュリティ API のベータ版が提供する 2 種類のアラートの 1 つです。 詳細については、「 アラート」を参照してください。

メソッド

メソッド	戻り値の型	説明
警告の取得	alert	警告オブジェクトのプロパティとリレーションシップを読み取ります。
警告の更新	alert	警告オブジェクトを更新します。
警告の一覧表示	alert コレクション	警告オブジェクトのコレクションを取得します。
複数のアラートを更新する	alert コレクション	複数のアラート オブジェクトを更新します。

プロパティ

プロパティ	種類	説明
activityGroupName	String	この警告に起因するアクティビティ グループ (攻撃者) の名前またはエイリアス。
assignedTo	String	トリアージ、調査、修復のために警告が割り当てられているアナリストの名前です (更新をサポートしています)。
azureSubscriptionId	String	Azure サブスクリプション ID (この警告が Azure リソースに関連している場合に提示されます)。
azureTenantId	String	テナント ID をMicrosoft Entraします。 必須です。
category	String	アラートのカテゴリ (credentialTheft、ランサムウェアなど)。
closedDateTime	DateTimeOffset	警告が閉じられた時刻。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表します。これは常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z のようになります (更新をサポートしています)。
cloudAppStates	cloudAppSecurityState コレクション	この警告に関連するクラウド アプリケーションについて、プロバイダーによって生成されるセキュリティ関連のステートフル情報。
comments	String コレクション	警告に対する顧客提供のコメント (顧客警告管理の場合) (更新をサポートしています)。
confidence	Int32	検出ロジックの信頼性 (1 ～ 100 のパーセンテージ値)。
createdDateTime	DateTimeOffset	警告が警告プロバイダーによって作成された時刻。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 必須です。
説明	String	警告の説明。
detectionIds	String コレクション	この警告エンティティに関連する警告のセット (各警告は個別のレコードとして SIEM にプッシュされます)。
eventDateTime	DateTimeOffset	アラートを生成するためのトリガーとして機能したイベントまたはイベントが発生した時刻。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 必須です。
feedback	alertFeedback	警告に関するアナリストのフィードバック。 使用可能な値は、unknown、truePositive、falsePositive、benignPositive です。 更新プログラムをサポートします。
fileStates	fileSecurityState コレクション	この警告に関連するファイルについて、プロバイダーによって生成されるセキュリティ関連のステートフル情報。
historyStates	alertHistoryState コレクション	アラートに対して行われたすべての更新の監査ログを含む alertHistoryStates のコレクション。
hostStates	hostSecurityState コレクション	この警告に関連するホストについて、プロバイダーによって生成されるセキュリティ関連のステートフル情報。
id	String	プロバイダーによって生成された GUID/一意の識別子。 読み取り専用です。 必須です。
incidentIds	String コレクション	現在の警告に関連するインシデントの ID。
lastModifiedDateTime	DateTimeOffset	警告エンティティが最後に変更された時刻。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
malwareStates	malwareState コレクション	この警告に関連したマルウェアについての脅威インテリジェンス。
networkConnections	networkConnection コレクション	この警告に関連するネットワーク接続について、プロバイダーによって生成されるセキュリティ関連のステートフル情報。
processes	process コレクション	この警告に関連するプロセスについて、プロバイダーによって生成されるセキュリティ関連のステートフル情報。
recommendedActions	String コレクション	警告の結果として実行する仕入先/プロバイダー推奨アクション (たとえば、マシンの分離、enforce2FA、再イメージ化ホスト)。
registryKeyStates	registryKeyState コレクション	この警告に関連するレジストリ キーについて、プロバイダーによって生成されるセキュリティ関連のステートフル情報。
securityResources	securityResource コレクション	現在の警告に関連するリソース。 たとえば、一部の警告では、これに Azure リソースの値が含まれる場合があります。
severity	alertSeverity	警告の重要度 - 仕入先/プロバイダーが設定します。 可能な値は、unknown、informational、low、medium、high です。 必須です。
sourceMaterials	String コレクション	アラートに関連するソース マテリアルへのハイパーリンク (URI) (アラートやログ検索用のプロバイダーのユーザー インターフェイスなど)。
status	alertStatus	警告のライフサイクル ステータス (ステージ)。 使用可能な値は、unknown、newAlert、inProgress、resolved です。 (更新をサポートしています)。 必須です。
タグ	String collection	アラートに適用でき、フィルター条件 ("HVA"、"SAW" など) として機能するユーザー定義可能なラベル ( 更新をサポート)。
title	String	警告タイトル。 必須です。
triggers	alertTrigger コレクション	警告をトリガーした特定のプロパティ (警告に表示されるプロパティ) に関するセキュリティ関連の情報。 警告には、複数のユーザー、ホスト、ファイル、IP アドレスに関する情報が含まれる場合があります。 このフィールドは、警告の生成をトリガーしたプロパティを示します。
userStates	userSecurityState コレクション	この警告に関連するユーザー アカウントについて、プロバイダーによって生成されるセキュリティ関連のステートフル情報。
vendorInformation	securityVendorInformation	セキュリティ製品/サービスの仕入先、プロバイダー、サブプロバイダーに関する詳細を含む複合型 (たとえば、仕入先 = Microsoft、プロバイダー = Windows Defender ATP、サブプロバイダー = AppLocker)。 必須です。
vulnerabilityStates	vulnerabilityState コレクション	この警告に関連した 1 つかそれ以上の脆弱性についての脅威インテリジェンス。

関係

なし。

JSON 表記

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

{
  "activityGroupName": "String",
  "assignedTo": "String",
  "azureSubscriptionId": "String",
  "azureTenantId": "String",
  "category": "String",
  "closedDateTime": "String (timestamp)",
  "cloudAppStates": [{"@odata.type": "microsoft.graph.cloudAppSecurityState"}],
  "comments": ["String"],
  "confidence": 1024,
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "detectionIds": ["String"],
  "eventDateTime": "String (timestamp)",
  "feedback": "@odata.type: microsoft.graph.alertFeedback",
  "fileStates": [{"@odata.type": "microsoft.graph.fileSecurityState"}],
  "historyStates": [{"@odata.type": "microsoft.graph.alertHistoryState"}],
  "hostStates": [{"@odata.type": "microsoft.graph.hostSecurityState"}],
  "id": "String (identifier)",
  "incidentIds": ["String"],
  "lastModifiedDateTime": "String (timestamp)",
  "malwareStates": [{"@odata.type": "microsoft.graph.malwareState"}],
  "networkConnections": [{"@odata.type": "microsoft.graph.networkConnection"}],
  "processes": [{"@odata.type": "microsoft.graph.process"}],
  "recommendedActions": ["String"],
  "registryKeyStates": [{"@odata.type": "microsoft.graph.registryKeyState"}],
  "securityResources": [{"@odata.type": "microsoft.graph.securityResource"}],
  "severity": "@odata.type: microsoft.graph.alertSeverity",
  "sourceMaterials": ["String"],
  "status": "@odata.type: microsoft.graph.alertStatus",
  "tags": ["String"],
  "title": "String",
  "triggers": [{"@odata.type": "microsoft.graph.alertTrigger"}],
  "userStates": [{"@odata.type": "microsoft.graph.userSecurityState"}],
  "vendorInformation": {"@odata.type": "microsoft.graph.securityVendorInformation"},
  "vulnerabilityStates": [{"@odata.type": "microsoft.graph.vulnerabilityState"}]
}