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...