名前空間: 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 | エンティティのテナント ID をAzureして、エンティティが属するテナントを決定します (マルチテナント サポート)。 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 to block.)。 必須。 |
| 列国 | securityActionState コレクション | アクションの履歴を保持する 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"}
}