名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
重要
従来のアラート API は非推奨となり、2026 年 10 月 15 日に廃止されます。 新しい アラートとインシデント API に移行します。 詳細については、「 レガシ アラートからアラートとインシデント 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 | Microsoft Entra テナント ID。 必須です。 |
| category | 文字列 | アラートのカテゴリ (例: 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"}]
}