名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Microsoft Graph のセキュリティの securityAction エンティティを使用して、脅威から保護するためのアクションをただちに実行します。 セキュリティ アナリストが、悪意のあるファイル、URL、ドメイン、IP アドレスなどの新しいインジケーターを発見した場合、Microsoft のセキュリティ ソリューションでそれらに対する保護をすぐに有効にできます。 特定のプロバイダーのアクションを呼び出し、実行されるすべての操作を表示し、必要な場合は操作を取り消します。 Windows Defender for Endpoint でセキュリティ対策を試し、アラートで確認されたプロパティや調査中に特定されたプロパティを使用して Windows エンドポイントでの悪意のあるアクティビティをブロックします。
注: 現在、セキュリティ アクションでサポートされているのは、アプリケーションのアクセス許可のみです。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| セキュリティ アクションを取得する | securityAction | securityAction オブジェクトのプロパティと関係を読み取ります。 |
| セキュリティ アクションを作成する | securityAction | securityActions コレクションに投稿して、新しい securityAction を作成します。 |
| セキュリティ アクションを一覧表示する | securityAction コレクション | securityAction オブジェクト コレクションを取得します。 |
| セキュリティ アクションをキャンセルする | なし | セキュリティ操作を取り消します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| actionReason | 文字列 | このアクションを呼び出す理由。 |
| appId | String | アクションを送信した (POST) 呼び出し元アプリケーションのアプリケーション ID。 appId は認証トークンから抽出する必要があり、呼び出し元のアプリケーションが手動で入力しないでください。 |
| azureTenantId | String | エンティティが属するテナントを決定するエンティティの Azure テナント ID (マルチテナント サポート)。 azureTenantId は、認証トークンから抽出される必要があり、呼び出し元のアプリケーションが手動で入力しないでください。 |
| clientContext | 文字列 | 一意のクライアント コンテキスト文字列。 最大 256 文字を指定できます。 |
| CompletedDateTime | DateTimeOffset | アクションが完了したときのタイムスタンプ。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| createdDateTime | DateTimeOffset | アクションが作成されたときのタイムスタンプ。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| errorInfo | resultInfo | アクションに失敗した場合のエラー情報。 |
| id | 文字列 | アクションが取り込まれるとシステムによって作成されます。 生成された GUID/一意識別子。 読み取り専用です。 |
| lastActionDateTime | DateTimeOffset | このアクションが最後に更新されたときのタイムスタンプ。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 |
| name | String | アクション名。 |
| parameters | keyValuePair コレクション | アクションを呼び出すために必要なパラメーター (キーと値のペア) のコレクション (ブロックする URL や fileHash など)。 必須。 |
| 状態 | securityActionState collection | アクションの履歴を保持するための securityActionState のコレクション。 |
| status | string | アクションの状態。 使用可能な値: NotStarted、Running、Completed、Failed。 |
| ユーザー | 文字列 | アクションを送信した (POST) サインイン ユーザーのユーザー プリンシパル名。 ユーザーは認証トークンから抽出される必要があり、呼び出し元のアプリケーションが手動で入力しないでください。 |
| vendorInformation | securityVendorInformation | セキュリティ製品/サービスのベンダー、プロバイダー、サブプロバイダーに関する詳細を含む複合型 (例: vendor=Microsoft、provider=Windows Defender ATP、sub-provider=AppLocker)。 |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"actionReason": "String",
"appId": "String",
"azureTenantId": "String",
"clientContext": "String",
"completedDateTime": "String (timestamp)",
"createdDateTime": "String (timestamp)",
"errorInfo": {"@odata.type": "microsoft.graph.resultInfo"},
"id": "String (identifier)",
"lastActionDateTime": "String (timestamp)",
"name": "String",
"parameters": [{"@odata.type": "microsoft.graph.keyValuePair"}],
"states": [{"@odata.type": "microsoft.graph.securityActionState"}],
"status": "string",
"user": "String",
"vendorInformation": {"@odata.type": "microsoft.graph.securityVendorInformation"}
}