simulationAutomation resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents simulation automation created to run on a tenant.

Inherits from entity.

Methods

Method Return type Description
List simulationAutomations simulationAutomation collection Get a list of attack simulation automations for a tenant.
Get simulationAutomation simulationAutomation Get an attack simulation automation for a tenant.
List runs simulationAutomationRun collection Get a list of the attack simulation automation runs for a tenant.

Properties

Property Type Description
createdBy emailIdentity Identity of the user who created the attack simulation automation.
createdDateTime DateTimeOffset Date and time when the attack simulation automation was created.
description String Description of the attack simulation automation.
displayName String Display name of the attack simulation automation. Supports $filter and $orderby.
id String Unique identifier for the attack simulation automation. Inherited from entity.
lastModifiedBy emailIdentity Identity of the user who most recently modified the attack simulation automation.
lastModifiedDateTime DateTimeOffset Date and time when the attack simulation automation was most recently modified.
lastRunDateTime DateTimeOffset Date and time of the latest run of the attack simulation automation.
nextRunDateTime DateTimeOffset Date and time of the upcoming run of the attack simulation automation.
status simulationAutomationStatus Status of the attack simulation automation. Supports $filter and $orderby. The possible values are: unknown, draft, notRunning, running, completed, unknownFutureValue.

simulationAutomationStatus values

Member Description
unknown The status of the simulation automation isn't defined.
draft The simulation automation is in draft mode.
notRunning The simulation automation isn't running.
running The simulation automation is running.
completed The simulation automation has completed.
unknownFutureValue Evolvable enumeration sentinel value. Don't use.

Relationships

Relationship Type Description
runs simulationAutomationRun collection A collection of simulation automation runs.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.simulationAutomation",
  "createdBy": {
    "@odata.type": "microsoft.graph.emailIdentity"
  },
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.emailIdentity"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "lastRunDateTime": "String (timestamp)",
  "nextRunDateTime": "String (timestamp)",
  "status": "String"
}