Microsoft Graph · Schema

microsoft.graph.security.ioTDeviceEvidence

Microsoft GraphAzure ADCollaborationContactsDocumentsEmailGraphIdentityMicrosoftOffice 365PresentationsProductivitySpreadsheetsT1Task

Properties

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

JSON Schema

microsoft-graph-microsoftgraphsecurityiotdeviceevidence-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/microsoft.graph.security.ioTDeviceEvidence",
  "title": "microsoft.graph.security.ioTDeviceEvidence",
  "allOf": [
    {
      "$ref": "#/components/schemas/microsoft.graph.security.alertEvidence"
    },
    {
      "title": "ioTDeviceEvidence",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "deviceId": {
          "type": "string",
          "description": "The device ID.",
          "nullable": true
        },
        "deviceName": {
          "type": "string",
          "description": "The friendly name of the device.",
          "nullable": true
        },
        "devicePageLink": {
          "type": "string",
          "description": "The URL to the device page in the IoT Defender portal.",
          "nullable": true
        },
        "deviceSubType": {
          "type": "string",
          "description": "The device subtype.",
          "nullable": true
        },
        "deviceType": {
          "type": "string",
          "description": "The type of the device. For example, 'temperature sensor,' 'freezer,' 'wind turbine,' and so on.",
          "nullable": true
        },
        "importance": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.security.ioTDeviceImportanceType"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "The importance level for the IoT device. Possible values are low, normal, high, and unknownFutureValue."
        },
        "ioTHub": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.security.azureResourceEvidence"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "The azureResourceEvidence entity that represents the IoT Hub that the device belongs to."
        },
        "ioTSecurityAgentId": {
          "type": "string",
          "description": "The ID of the Azure Security Center for the IoT agent that is running on the device.",
          "nullable": true
        },
        "ipAddress": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.security.ipEvidence"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "The current IP address of the device."
        },
        "isAuthorized": {
          "type": "boolean",
          "description": "Indicates whether the device classified as an authorized device.",
          "nullable": true
        },
        "isProgramming": {
          "type": "boolean",
          "description": "Indicates whether the device classified as a programming device.",
          "nullable": true
        },
        "isScanner": {
          "type": "boolean",
          "description": "Indicates whether the device classified as a scanner.",
          "nullable": true
        },
        "macAddress": {
          "type": "string",
          "description": "The MAC address of the device.",
          "nullable": true
        },
        "manufacturer": {
          "type": "string",
          "description": "The manufacturer of the device.",
          "nullable": true
        },
        "model": {
          "type": "string",
          "description": "The model of the device.",
          "nullable": true
        },
        "nics": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/microsoft.graph.security.nicEvidence"
          },
          "description": "The current network interface controllers on the device."
        },
        "operatingSystem": {
          "type": "string",
          "description": "The operating system the device is running.",
          "nullable": true
        },
        "owners": {
          "type": "array",
          "items": {
            "type": "string",
            "nullable": true
          },
          "description": "The owners for the device."
        },
        "protocols": {
          "type": "array",
          "items": {
            "type": "string",
            "nullable": true
          },
          "description": "The list of protocols that the device supports."
        },
        "purdueLayer": {
          "type": "string",
          "description": "The Purdue Layer of the device.",
          "nullable": true
        },
        "sensor": {
          "type": "string",
          "description": "The sensor that monitors the device.",
          "nullable": true
        },
        "serialNumber": {
          "type": "string",
          "description": "The serial number of the device.",
          "nullable": true
        },
        "site": {
          "type": "string",
          "description": "The site location of the device.",
          "nullable": true
        },
        "source": {
          "type": "string",
          "description": "The source (microsoft/vendor) of the device entity.",
          "nullable": true
        },
        "sourceRef": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.security.urlEvidence"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "A URL reference to the source item where the device is managed."
        },
        "zone": {
          "type": "string",
          "description": "The zone location of the device within a site.",
          "nullable": true
        },
        "@odata.type": {
          "type": "string",
          "default": "#microsoft.graph.security.ioTDeviceEvidence"
        }
      }
    }
  ],
  "x-ms-discriminator-value": "#microsoft.graph.security.ioTDeviceEvidence"
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/microsoft-graph-microsoftgraphsecurityiotdeviceevidence"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.