reportRoot: getAttackSimulationSimulationUserCoverage (非推奨)
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
攻撃 シミュレーション とトレーニング キャンペーンでテナントのユーザーのシミュレーション カバレッジを取得します。
この関数では、改ページ調整がサポートされています @odata.nextLink 。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | 特権の高いアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | AttackSimulation.Read.All | 注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | AttackSimulation.Read.All | 注意事項なし。 |
HTTP 要求
注意
エンドポイントから https://graph.microsoft.com/beta/reports/security 次のメソッドに必ずアクセスしてください。
- getAttackSimulationRepeatOffenders
- getAttackSimulationSimulationUserCoverage
- getAttackSimulationTrainingUserCoverage
これらのメソッドのクエリ エンドポイントが から https://graph.microsoft.com/beta/reports に https://graph.microsoft.com/beta/reports/security変更されました。
エンドポイントの https://graph.microsoft.com/beta/reports/ メソッドは 2022 年 7 月 15 日の時点で非推奨となり、2022 年 8 月 20 日以降、データの返しを停止します。
GET /reports/getAttackSimulationSimulationUserCoverage
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、この関数は 200 OK 応答コードと、応答本文で attackSimulationSimulationUserCoverage コレクションを返します。
例
要求
GET https://graph.microsoft.com/beta/reports/getAttackSimulationSimulationUserCoverage
応答
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"simulationCount": 2,
"latestSimulationDateTime": "2021-01-01T01:01:01.01Z",
"clickCount": 1,
"compromisedCount": 1,
"attackSimulationUser": {
"userId": "99af58b9-ef1a-412b-a581-cb42fe8c8e21",
"displayName": "Sample User",
"email": "sampleuser@contoso.com"
}
}
]
}
関連コンテンツ
securityReportsRoot: getAttackSimulationSimulationUserCoverage