2022-12-21

Cisco DNA Center Platform API Release 2.3.5

Devices APIs Support is extended for the following:

  • Rogue additional detail count.
  • Rogue additional details.

End of Life (EoX) APIs Support is extended for the following:

  • Get EoX status for all devices.
  • Get EoX details per device.
  • Get EoX summary.

Policy APIs Support is extended for the following:

  • Apply ANC policy.
  • Get ANC policies.
  • Revoke ANC policy.
  • Update a registered endpoint.
  • Get the count of endpoints and task details.
  • Get AI endpoint analytics attribute dictionaries.
  • Get endpoint details.
  • Delete an endpoint
  • Query the endpoints.
  • Register an endpoint.
  • Process CMDB endpoints.

Discovery API Support is extended for the following:

  • Get, Create, Update, and Delete Global Credential V2.

LAN Automation API Support is extended for the following:

  • LAN automation logs for individual devices.
  • LAN automation active sessions.

System Settings API Support is extended for the following:

  • Get authentication and policy servers.

2022-09-21

Cisco DNA Center Platform API Release 2.3.4

Cisco Software-Defined Access APIs: Support is extended for the following:

  • Get Cisco SD-Access transit network detail.
  • Create and delete Cisco SD-Access transit network.

Cisco Wireless APIs:

Support is extended for new options in the Wireless API for access point configuration and reboot access point:

  • Get access point configuration task result.
  • Get access point configuration.
  • Configure access points.

Support is extended for new options in the Wireless API for reboot access point:

  • Get a reboot access point.
  • Add the threat MAC address to the allowed list.

Cisco DNA Center System Platform API:

Support is extended for new options in the Platform API for reboot access point:

  • Get the Cisco DNA Center release summary.
  • Get the Cisco DNA Center nodes configuration summary.
  • Get the Cisco DNA Center packages summary.

Cisco DNA Center System User and Roles API:

Support is extended for new options in the User and Roles API for reboot access point:

  • Add a new user for Cisco DNA Center system.
  • Get all users and roles for the Cisco DNA Center system.
  • Get permissions for a role from Cisco DNA Center system.
  • Get external users authentication servers.
  • Update a user for Cisco DNA Center system.

Issues API:

Support is extended for a new option in the Issues API for reboot access point:

  • Execute suggested actions command.

Event Management API:

Support is extended for new options in the Event Management API for reboot access point:

  • Get webhook destination, syslog destination, Email destination, and SNMP destination.

Network Settings API:

Support is extended for new options in the Network Settings API for reboot access point:

  • Get device credential and service provider details.
  • Get SNMP, NTP, Network AAA, Client and Endpoint AAA, and/or DNS center server settings.
  • Create device credentials.
  • Assign device credential to site.
  • Create network settings for DHCP, Syslog, SNMP, NTP, Network AAA, Client and Endpoint AAA, and/or DNS center server settings.
  • Create, update, and delete service provider profile (QoS).
  • Update network settings for DHCP, Syslog, SNMP, NTP, Network AAA, Client and Endpoint AAA, and/or DNS center server settings.
  • Update and delete device credentials.

2022-04-26

Cisco DNA Center Platform API Release 2.3.3

Cisco SD-Access API: Support is extended for the following:

  • Get a virtual network summary.
  • Get a transit peer network information from Cisco SD-Access.
  • Add a transit peer network in Cisco SD-Access.
  • Delete a transit peer network from Cisco SD-Access.

Note: All the Cisco SD-Access platform APIs are Beta.

With this release, the following Cisco SD-Access APIs are deprecated from Cisco DNA Center platform:

  • Get Cisco SD-Access fabric information.
  • Get Cisco SD-Access fabric count.
  • Add a Cisco SD-Access fabric.
  • Delete a Cisco SD-Access fabric.

Devices API: Support is extended for the following:

  • Add or update voice VLAN to perform devices operations.
  • Get all the defined threat types.
  • Get all the allowed MAC addresses in the system.
  • Remove the threat MAC address from the allowed list.
  • Get all the defined threat levels.
  • Add the threat MAC address to the allowed list.
  • Get the count of allowed MAC addresses in the system.

Cisco DNA Center System API: Support is extended for the following:

  • Authorize one or more devices. Cisco DNA Center platform allows you to authorize a device only if the authorization is configured in device settings.

2021-08-04

Cisco DNA Center Platform API Release 2.2.3

Application Policies: Support is extended for the following:

  • Application Policy Queuing Profile APIs:
    • Get all the existing application policy queuing profiles.
    • Get all the existing application policy queuing profiles by name.
    • Get the number of all existing application policy queuing profiles.
    • Create, update, and delete custom application queuing profiles.
  • Quality of Service (QoS) Device Interface Information APIs
    • Get all the existing QoS device interface information.
    • Get all the existing QoS device interface information by network device ID.
    • Get the number of all existing QoS device interface information groups by network device ID.
    • Create, update, and delete QoS device interface information associated with network device ID.
  • Application Policy APIs
    • Get the default application policy.
    • Get all existing application policies.
    • Create, update, and delete application policies.
  • AI Endpoint Analytics APIs to manage profiling rules for the endpoint.

Application: This Cisco DNA Center platform release supports a new Application API that allows you to get a list of issues, devices, and endpoints for a combination of a specific application with a site or device.

Configuration Templates: Support is extended for Get project(s) and Get template(s) details with more input filter parameters.

Device Onboarding (PnP): In the PnP workflow, the Cisco DNA Center platform now allows you to bypass the provisioning workflow and provision multiple access point devices by using an API.

Site Design: The Cisco DNA Center platform now allows you to support associate and disassociate a site to a network profile.

Task: The Cisco DNA Center platform now allows you to retrieve the execution details of a business API.

SWIM: Support is extended for the following:

  • Device family identifiers for all device families that can be used for tagging an image as a golden image.
  • Tag a golden image. Set siteId as -1 for a global site.
  • Remove a golden tag. Set siteId as -1 for a global site.
  • Get the golden tag status of an image. Set siteId as -1 for a global site.

2021-04-23

Cisco DNA Center Platform API Release 2.2.2.x

Cisco Software-Defined Access APIs: Support is extended for the following:

  • Get virtual network with scalable groups.
  • Update virtual network with scalable groups.
  • Add virtual network with scalable groups at the global level.
  • Get multicast details from the SD-Access fabric.
  • Delete virtual network with scalable groups.

SD-Access APIs (Beta):

  • Provision wired and wireless device.
  • Add multicast in SD-Access fabric.
  • Add, update, and get the SSID-to-IP pool mapping.
  • Add and remove wireless controllers in the fabric domain.

Reports APIs: Support is extended for the following:

  • Retrieve a list of summaries of all views for a given view group.
  • Retrieve the complete information of the view that is required to configure a report.
  • Retrieve the list of scheduled report configurations.
  • Retrieve a list of summaries of all view groups.
  • Retrieve the details of all executions for a given report.
  • Retrieve the scheduled report configuration using report ID.
  • Retrieve the report content.
  • Create and schedule a report configuration.
  • Delete a scheduled report configuration and report executions.

License Manager APIs: Support is extended for the following:

  • Retrieve a list of smart and virtual accounts.
  • Retrieve license information details.
  • Retrieve license details by device ID.

IPAM APIs:

  • Retrieve a list of smart accounts.
  • Post a list of virtual accounts and licenses.
  • Delete license information details.

PnP APIs: This Cisco DNA Center platform release supports a new option in the PnP claim API that indicates if user authorization is needed for the claim to complete.

SWIM Automation APIs:

  • Create and update a SWIM upgrade request.
  • Create and update a SWIM upgrade request - ServiceNow Connector
  • Update ITSM details

New Supervisor and Line Card API Detail: This release supports updated APIs that provide additional information about Cisco supervisor and line cards.

New Device Link Mismatch API Support: This release supports updated APIs that provide additional information about device link mismatches.

New Display PoE Interface API: This release supports updated APIs that display device interface PoE data.

Audit Log API Updates: The following updates have been made in the Audit Log API for this release.

  • Different descriptions for Get Audit Log Records and Get Audit Log parent records. They are no longer the same.
  • New descriptions and default values for attributes.
  • For the map data types, only details and additional details are the map type attributes. Others are strings and the schema has been updated.
  • The feature section of Get Audit Log Summary has been updated to state that it returns a summary and also briefly mention the purging mechanism set up for audit logs (1 million records or 1 year, whichever is earlier).
  • The Sort, Order, Limit, and Offset parameters have been removed from the Summary API.

2020-08-31

Cisco DNA Center Platform API Release 2.1.2.x

Clients APIs: Support is extended for the following:

  • New client proximity API to support client tracing.
  • Updated the wireless API to support client tracing.

Application API: The Cisco DNA Center platform now returns a list of applications for a specific site, a device, or a client device MAC address.

Assurance APIs: Support is extended for the following:

  • Return overall health information for all sites.
  • Return a list of global issues, issues for a specific device, or issues for a specific client device's MAC address.
  • Access Assurance device objects for generating reports, creating dashboards, or creating additional value-added services.

Assurance Sensor APIs: Support is extended for the following:

  • Create a sensor test template.
  • Delete an existing sensor test.
  • Duplicate an existing sensor test template.
  • Return a list of sensor devices.
  • Deploy, schedule, or edit a sensor test.
  • Run a sensor test.

Configuration Archive API: The Cisco DNA Center platform now supports the export of device configurations to an encrypted zip file.

Device Replacement APIs: Support is extended for the following:

  • Unmark the device for replacement.
  • Mark the device for replacement.
  • Trigger an RMA workflow that replaces the faulty device with a replacement device with the same configuration and images.
  • Retrieve the replacement device count.
  • Retrieve the replacement list of devices with details and filter the results based on Faulty Device Name, Faulty Device Platform, and Replacement.

Event Retry APIs: This release supports new retry (resend and reprocess) APIs for an ITSM (ServiceNow) event.

IP Pool APIs: The Cisco DNA Center platform supports new bulk functionality for IP and global pools.

NFV Profile APIs: Support is extended for the following:

  • Create a network profile for different Network Functions Visualization (NFV) topologies.
  • Update an existing NFV profile. To update the NFV profile, you must provide either the site profile ID as a mandatory path parameter or the site profile name as a query parameter.
  • Retrieve the NFV network profile details. The ID of the profile to be retrieved is provided as the path parameter. If the ID is not provided, you can provide the site profile name to retrieve the details.
  • Delete the NFV network profile. You must provide either the ID or the site profile name.

Rogue Management Threat APIs: Support is extended for the following:

  • The threat summary for the rogues and aWIPS.
  • The detail counts for the rogue and aWIPS threats.
  • The details for the rogue and aWIPS threats.

SD-Access APIs: Support is extended for the following:

  • Retrieve the number of fabrics.
  • Retrieve the SD-Access role of a device.

2020-01-17

Cisco DNA Center Platform API Release 1.3.3.x

Cisco Software-Defined Access APIs (Beta): Support is extended for the following:

  • Fabric creation.
  • Fabric site in the SD-Access fabric.
  • Control plane device APIs.
  • Edge device lifecycle management in the SD-Access fabric.
  • Border device business APIs.
  • Default Authentication Template (Profile) selection for host onboarding in the SD-Access fabric.
  • Virtual network creation in the SD-Access fabric.
  • Add IP pools to virtual networks (SD-Access segment life management).
  • Port assignment for user devices.
  • Port assignment to APs.

Network Settings API: Support is extended for the following:

  • Create, update, and retrieve a network.
  • Create and update device credentials.
  • Create and update a service provider profile.
  • Create, update, and retrieve a global IP address pool.
  • Retrieve device details by IP address.