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 stringrequired

    The customer ID to which the API call is directed

    updateSource stringrequired

    The source of the device information: SNMP


    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