Skip to main content

Bulk Device Updates - Cisco DNAC and Prime​

Update devices in your IoT Security inventory with select device information that Cortex XSOAR retrieves from an integrated Cisco DNA Center or Cisco Prime instance.

Query Parameters
  • customerid string required

    The customer ID to which the API call is directed

Request Body required
  • devicelist object[] required

    Array of device attributes from the integrated DNA Center or Prime instance

  • Array [
  • deviceid string

    The MAC address of a device in the Cisco DNA Center or Prime inventory. IoT Security uses it to link attributes from a device in the other inventory to one in its own inventory.

  • config_source string

    Possible values: [dnac, prime]

    The source of the device information: "dnac" or "prime"

  • ip string

    The device IP address

  • location string

    The location of the device as learned from the location setting on the Cisco switch or access point to which the device connects

  • ap_ip string

    The IP address of the access point through which the device makes a wireless connection to the network

  • ap_name string

    The name of the access point through which the device makes a wireless connection to the network

  • SSID string

    The SSID on which the device associates with the access point

  • switchIP string

    The IP address of the switch to which the device makes a wired connection to the network

  • switchName string

    The hostname of the switch to which the device makes a wired connection to the network

  • switchPort string
  • switch_if_name string

    The Ethernet interface on the switch through which the device makes a wired connection to the network

  • vlan string

    The ID of the VLAN that the device is in

  • vlan_name string

    The name of the VLAN that the device is in

  • WireWireless string

    The type of network connection for the device: wired or wireless

  • ]
Responses

Successful Response

Schema
  • 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

Loading...