ioTDeviceEvidence resource type

Namespace: microsoft.graph.security

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 an IoT device that is reported as part of the security detection alert.

Inherits from alertEvidence.

Properties

Property	Type	Description
ioTHub	microsoft.graph.security.azureResourceEvidence	The azureResourceEvidence entity that represents the IoT Hub that the device belongs to.
deviceId	String	The device ID.
deviceName	String	The friendly name of the device.
owners	Collection(String)	The owners for the device.
ioTSecurityAgentId	String	The ID of the Azure Security Center for the IoT agent that is running on the device.
deviceType	String	The type of the device. For example, "temperature sensor," "freezer," "wind turbine," and so on.
source	String	The source (microsoft/vendor) of the device entity.
sourceRef	microsoft.graph.security.urlEvidence	A URL reference to the source item where the device is managed.
manufacturer	String	The manufacturer of the device.
model	String	The model of the device.
operatingSystem	String	The operating system the device is running.
ipAddress	microsoft.graph.security.ipEvidence	The current IP address of the device.
macAddress	String	The MAC address of the device.
nics	Collection(microsoft.graph.security.nicEvidence)	The current network interface controllers on the device.
protocols	Collection(String)	The list of protocols that the device supports.
serialNumber	String	The serial number of the device.
site	String	The site location of the device.
zone	String	The zone location of the device within a site.
sensor	String	The sensor that monitors the device.
importance	microsoft.graph.security.ioTDeviceImportanceType	The importance level for the IoT device. Possible values are low, normal, high, and unknownFutureValue.
purdueLayer	String	The Purdue Layer of the device.
isProgramming	Boolean	Indicates whether the device classified as a programming device.
isAuthorized	Boolean	Indicates whether the device classified as an authorized device.
isScanner	Boolean	Indicates whether the device classified as a scanner.
devicePageLink	String	The URL to the device page in the IoT Defender portal.
deviceSubType	String	The device subtype.

ioTDeviceImportanceType values

Member	Description
low	Low importance.
normal	Normal importance.
high	High importance.
unknownFutureValue	Evolvable enumeration sentinel value. Do not use.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.security.ioTDeviceEvidence",
  "createdDateTime": "String (timestamp)",
  "verdict": "String",
  "remediationStatus": "String",
  "remediationStatusDetails": "String",
  "roles": [
    "String"
  ],
  "tags": [
    "String"
  ],
  "iotHub": {
    "@odata.type": "microsoft.graph.security.azureResourceEvidence"
  },
  "deviceId": "String",
  "deviceName": "String",
  "owners": [
    "String"
  ],
  "iotSecuritySolutionId": "Guid",
  "deviceType": "String",
  "deviceTypeId": "String",
  "source": "String",
  "sourceRef": {
    "@odata.type": "microsoft.graph.security.urlEvidence"
  },
  "manufacturer": "String",
  "model": "String",
  "operatingSystem": "String",
  "ipAddress": {
    "@odata.type": "microsoft.graph.security.ipEvidence"
  },
  "nics": [
      {
      "@odata.type": "microsoft.graph.security.nicEvidence"
    },
  ],
  "protocols": [
    "String"
  ],
  "serialNumber": "String",
  "site": "String",
  "zone": "String",
  "sensor": "String",
  "importance": {
      "@odata.type": "microsoft.graph.security.ioTDeviceImportanceType"
    },
  "purdueLayer": "String",
  "isProgramming": "Boolean",
  "isAuthorized": "Boolean",
  "isScanner": "Boolean",
  "devicePageLink": "String",
  "deviceSubType": "String",
}