Skip to main content

Bulk Device Updates - SNMP

Update devices in your IoT Security inventory with device information that Cortex XSOAR retrieves from integrated switches through SNMP.

Query Parameters
  • customerid string required

    The customer ID to which the API call is directed

  • updateSource string required

    The source of the device information: SNMP

Request Body required
  • devicelist object[] required

    Array of device attributes from integrated switches using SNMP

  • Array [
  • deviceid string

    The MAC address of a device connected to a switch. IoT Security uses it to link device attributes from a switch to a device in its inventory.

  • connect_evtContent.ip string

    The IP address of the device connected to a switch

  • display_switchName string

    The name of the switch to which the device is connected

  • display_phyPort string

    The physical port on the switch to which the device is connected. Only Cisco Catalyst switches return this information.

  • display_switchIP string

    IP addresses of neighboring switches

  • ]

Successful Response

  • api string

    The path used to call the IoT Security API: “device/bulkupdate”

  • ver string

    The version of the IoT Security API: “v4.0”

  • code string

    The code number indicating success: 1

  • message string

    The message indicating success: “OK”

  • updatedDeviceNum integer

    The number of devices that IoT Security successfully updated