次の方法で共有


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 警告に関するアナリストのフィードバック。 使用可能な値は、unknowntruePositivefalsePositivebenignPositive です。 更新プログラムをサポートします。
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 警告の重要度 - 仕入先/プロバイダーが設定します。 可能な値は、unknowninformationallowmediumhigh です。 必須です。
sourceMaterials String コレクション アラートに関連するソース マテリアルへのハイパーリンク (URI) (アラートやログ検索用のプロバイダーのユーザー インターフェイスなど)。
status alertStatus 警告のライフサイクル ステータス (ステージ)。 使用可能な値は、unknownnewAlertinProgressresolved です。 (更新をサポートしています)。 必須です。
タグ 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"}]
}