API Changelog

The following sections describe API changes in each release of Nexus Dashboard Fabric Controller.

Release 12.1.2 (2023-01-31)

For additional information about the release, see the Release Notes.

What's New

POST /appcenter/cisco/ndfc/api/v1/alarm/alarms/deletesourcealarm

Enable / Disable Alarms

POST /appcenter/cisco/ndfc/api/v1/configtemplate/rest/config/templates/jobs

Get Jobs list

GET /appcenter/cisco/ndfc/api/v1/event/about
GET /appcenter/cisco/ndfc/api/v1/event/about/status
GET /appcenter/cisco/ndfc/api/v1/event/about/version
GET /appcenter/cisco/ndfc/api/v1/event/api/getTrapSyslogIP

Get the external IP for trap and syslog

GET /appcenter/cisco/ndfc/api/v1/event/em/getAccounting

Get accounting records from database

GET /appcenter/cisco/ndfc/api/v1/event/em/getEvent

Get event records from database

GET /appcenter/cisco/ndfc/api/v1/event/em/getEventForwarders

Get event forwarder rules

GET /appcenter/cisco/ndfc/api/v1/event/em/getEventRegistrationSource

Get event registration source

GET /appcenter/cisco/ndfc/api/v1/event/em/getEventRegistrationStatus

Get event registration status

GET /appcenter/cisco/ndfc/api/v1/event/em/getEventSuppressors

Get event suppressor rules

GET /appcenter/cisco/ndfc/api/v1/fm/about/version

NDFC Version

GET /appcenter/cisco/ndfc/api/v1/fm/features

Get Feature list

POST /appcenter/cisco/ndfc/api/v1/fm/features

Enable/Disable Features

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/imageupload/smart-image-upload

upload images

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/overview/fabrics

Switch fabrics

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/overview/policies

Image policies

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/overview/switch-groups

Switch groups

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/overview/upload

Uploaded images

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/poap/servers
GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/discovery/bootflash-discovery

Bootflash discovery

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/discovery/discovery

Rediscover switch contents

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/discovery/package-discovery

Rediscover RPM/SMU

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/imagehistory/history

History

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/imagehistory/history/{id}

History by action

DELETE /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/imagemgnt/bootFlash/bootflash-files

Delete bootflash content

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/imagemgnt/bootFlash/bootflash-info

Bootflash contents

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/imagereports/get-report-name

Report name.

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/imagereports/issu-upgrade-report

ISSU Report

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/imageupgrade/install-options

Install upgrade options

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/imageupgrade/upgrade-image

Upgrade ISSU image

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/imageupgrade/upgrade-options

Upgrade Options

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/imageupload/scp-upload

SCP upload

DELETE /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/imageupload/smart-image

Delete images

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/imageupload/uploaded-images-table

Uploaded images

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/packagemgnt/activate

Activate package

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/packagemgnt/deactivate

Deactive package

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/packagemgnt/getpackagelist

RPM/SMU packages

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/packagemgnt/install

Install package

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/packagemgnt/issu

Device list

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/packagemgnt/uninstall

Uninstall package

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/packagemgnt/uploaded-packages

Uploaded RPM/SMUs

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/packagemgnt/{fabricId}/issu

List the device(s) for ISSU

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/policymgnt/attach-policy

Attach policy

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/policymgnt/attached-policies

Attached policy

DELETE /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/policymgnt/detach-policy

Detach Image policy

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/policymgnt/edit-policy

Edit Policy

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/policymgnt/edit-policy-get/{policyname}

Get policy

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/policymgnt/epld/{platform}

Epld images

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/policymgnt/image-policy/{policyname}

Policy details.

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/policymgnt/nxos/{platform}

Nxos version

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/policymgnt/packages/{platform}

Packages

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/policymgnt/platform-policies

Platform Policies

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/policymgnt/platform-policy

Create Image Policy

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/policymgnt/platforms

Image platforms

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/policymgnt/policies

Policies

DELETE /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/policymgnt/policy

Delete Image policy

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/policymgnt/recalculate-compliance

Image compliance check

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/stagingmanagement/change-device-mode

Change device mode

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/stagingmanagement/change-group

Change upgrade group

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/stagingmanagement/create-group

Create upgrade group

DELETE /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/stagingmanagement/detach-group

Detach upgrade group

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/stagingmanagement/groups

Upgrade groups

GET /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/stagingmanagement/reason-description/{serialNumber}/{policyName}

Install logs

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/stagingmanagement/stage-image

Stage Image

POST /appcenter/cisco/ndfc/api/v1/imagemanagement/rest/stagingmanagement/validate-image

Compatibility check

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/config/delivery/deployerHistoryByFabric/{fabricName}

Deployer History

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/msdAdd

MSD fabric addition

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/msdExit

MSD fabric exit

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/freezemode

Check accessMode for the given fabric.

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/inventory/poap/dhcpscopes

List Inband POAP DHCP scopes for specified Numbered (p2p) Fabric.

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/swapSN/{oldSN}/{newSN}

Swap serial number of the given switch for pre-provision case

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/switches/{serialNumber}/maintenance-mode

Enable the maintenance mode

DELETE /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/switches/{serialNumber}/maintenance-mode

Remove the switch from maintenance mode

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/policies/ptiHistory/switchesByFabric/{fabricName}

Get the Pti History for the switches under given fabric

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/policies/ptiHistoryData/switchesByFabric/{fabricName}

Get the Pti History for the switches under given fabric

PUT /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/policies/{policyIds}/bulk

Update policy in bulk

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/globalInterface/all-diffs

Display interface diff

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/lanConfig/deleteCredentials

Delete Credentials

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/lanConfig/deleteDefaultCredentials

Delete Default Credentials

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/lanConfig/deleteRobotDefaultCredentials

Delete Robot Credentials

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/lanConfig/saveDefaultCredentials

Save Lan Default Credentials

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/lanConfig/saveRobotCredentials

Save Robot Credentials

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/lanConfig/saveSwitchCredentials

Save Switch Credentials

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/resource-manager/fabrics/{fabricName}/resources

Add/Allocate a Resource

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/bulk-create/networks

Create Bulk Network

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/bulk-create/vrfs

Create Bulk VRF

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/hasprimaryorsecondarynetworks

Check primary or secondary network

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/primarynetworks

List Primary Networks

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/networks/preview

Preview Networks

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/vrfs/deploy

Deploy/Undeploy VRFs/VRF-Lite

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/vpcpair

Api to create a vpc pair

GET /appcenter/cisco/ndfc/api/v1/pm/getPMWorkerStatus

Get PM Worker Status

GET /appcenter/cisco/ndfc/api/v1/pm/stat/LanEthernetStatBySwIDs

Get all LAN Ethernet Ports filtered by switch ID List, e.g. 1100,1200,1300

POST /appcenter/cisco/ndfc/api/v1/pm/stat/LanEthernetStatBySwIDsAndIfName

Get all LAN Ethernet Ports filtered by switch ID List, e.g. 1100,1200,1300 and swIdIfName json string

GET /appcenter/cisco/ndfc/api/v1/pmn/rtp/pathtrace/fabrics/{fabric-name}/vrf/{vrf}/source/{source}/group/{group}

Fetch the path trace for given source, group with optional receiver ips

GET /appcenter/cisco/ndfc/api/v1/ptp/highcorrections
GET /appcenter/cisco/ndfc/api/v1/ptp/highcorrections/dates
GET /appcenter/cisco/ndfc/api/v1/ptp/highcorrections/threshold
DELETE /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}

Delete the given fabric

What's Deleted

GET /appcenter/cisco/ndfc/api/v1/alarm/alarms/gethistoryalarms
GET /appcenter/cisco/ndfc/api/v1/alarm/alarms/getraisedalarms

What's Changed

DELETE /appcenter/cisco/ndfc/api/v1/configtemplate/rest/config/templates/delete/bulk
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/accessmode
Parameters:

Changed: fabricName in path

Fabric Name

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/config-deploy
Return Type:

Changed response : 500 Internal Server Error

Fabric name is invalid or config deployment failed due to internal server error

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/config-deploy/{switchId}
Return Type:

Changed response : 500 Internal Server Error

Fabric name is invalid or config deployment failed due to internal server error

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/config-preview
Parameters:

Changed: forceShowRun in query

ForceShowRun

Changed: showBrief in query

ShowBrief

Changed: inclAllMSDSwitches in query

inclAllMSDSwitches

Changed: shRunOptimization in query

shRunOptimization

Return Type:

Changed response : 500 Internal Server Error

Fabric name is invalid or Config could not be generated due to server internal error

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/config-preview/source/{sourceName}/{switchId}
Parameters:

Changed: sourceName in path

Source Name

Changed: switchId in path

Switch ID

Changed: forceShowRun in query

ForceShowRun

Changed: showBrief in query

ShowBrief

Return Type:

Changed response : 500 Internal Server Error

Fabric name is invalid or Config could not be generated due to server internal error

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/config-preview/{switchId}

Config preview for the given fabric and switch.

Parameters:

Changed: fabricName in path

Fabric Name

Changed: switchId in path

Switch Id

Changed: forceShowRun in query

ForceShowRun

Changed: showBrief in query

ShowBrief

Changed: recomputeMapEnable in query

RecomputeMapEnable

Changed: shRunOptimization in query

shRunOptimization

Return Type:

Changed response : 500 Internal Server Error

Fabric name is invalid or Config could not be generated due to server internal error

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/config-save
POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/switches/{serialNumber}/deploy-maintenance-mode
Parameters:

Changed: fabricName in path

Fabric Name

Changed: serialNumber in path

Serial Number

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/{templateName}
Parameters:

Changed: fabricName in path

Fabric Name

Changed: templateName in path

Template Name

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/links/fabrics/{fabricName}
Parameters:

Changed: fabricName in path

Fabric Name

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/links/import
Request:

Example Request Body (make sure each entry starts on a new line): Link Template,Source Fabric,Destination Fabric,Source Device,Destination Device Source SwitchName,Destination SwitchName,Source Interface,Destination Interface,nv-pairs Inter-Fabric/Intra-Fabric,

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/links/logical-links/switch/{serialNumber}
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/links/logical-links/{fabricName}
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/policies/key
Parameters:

Changed: type in query

type - One of the three option(DevicePair/DeviceInterface/Link)

*SN = Device_Serial_Number

If type = "DevicePair", paramOne = SN1 & paramTwo = SN2

If type = "DeviceInterface", paramOne = SN1 & paramTwo = Interface name of SN1

If type ="Link", paramOne = SN1 & paramTwo = Interface name of SN1 & paramThree = SN2 & paramFour = Interface name of SN2

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/policies/switches/{serialNumber}
Parameters:

Changed: source in query

This is an optional field. Example: UNDERLAY, OVERLAY, loopback0, Ethernet1/5

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/policies/switches/{serialNumber}/{entityType}/{entityName}
Parameters:

Changed: serialNumber in path

Switch Serial Number

Changed: entityType in path

Entity Type

Changed: entityName in path

Entity Name

Changed: responseType in query

Response Type

PUT /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/policies/switches/{serialNumber}/{entityType}/{entityName}

Mark delete the policies based on given serial number, entity type, and entity name

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/switches/{serialNumber}/myip

To get the IP address as used by DCNM import, for given switch serial number

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/interface/vpcpair_serial_number
Return Type:

Changed response : 500 Internal Server Error

The specified serial number is not part of a vPC pair or any other internal server error.

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/l4l7-service/fabrics/{fabric-name}/servicenetworks
POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/bulk-import/networks
Parameters:

Added: fabric-name in query

Fabric Name

Request:

Request Body (make sure each entry starts on a new line): Headers : fabric,vrf,displayName,networkId,networkTemplate,networkExtensionTemplate,networkName,standbyPriority,type,pip1, preempt,mac,pip2,GROUP,isLayer2Only,VRRP_ENABLE,HSRP_VERSION,gatewayIpV6Address,ipv6_pip2, ipv6_pip1,tag,redundancyType,vlanId,gatewayIpAddress,vlanName,mtu,ipv6_linklocal_vip,intfDescription,activePriority, intfDescription2,dhcpServers Row Values: easy_classic,MyVRF_50000,MyNetwork_30000,30000,Network_Classic,Network_Classic,MyNetwork_30000,100,Normal, 2.2.2.3,true,,2.2.2.4,1,false,false,2,,,,12345,hsrp,2300,2.2.2.2/24,,,,,120,,

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/bulk-import/networks/attachments
Parameters:

Added: fabric-name in query

Fabric Name

Request:

CSV File

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/bulk-import/vrfs
Parameters:

Added: fabric-name in query

Request:

CSV example file can be downloded from VRF List page using export option under action menu.

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/bulk-import/vrfs/attachments
Parameters:

Added: fabric-name in query

Request:

Eg ReqBody (each entry starts with a new line):\nfabric,vrfname,serialnumber_1,islanattached,vlan,freeformconfig_1

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/export/networks/attachments
Request:

Network entity. Eg - {"FDO2020095D":"MyNetwork_30000"}

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/export/vrfs/attachments
Request:

VRF entity

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/networks/preview
Return Type:

Changed response : 200 OK

Returns the preview config for the pending (Un)deploy for the networks

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/networks/switches
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/networks/switches/history
POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/networks/{network-name}/deploy
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/networks/{network-name}/status
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/networks/{network-name}/switches/{serial-number}/history
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/networks/{network-name}/switches/{serial-number}/ports
DELETE /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/servicenetworks/{network-name}
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/vrfs/switches/history
POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/bulk-import/networks
Parameters:

Added: fabric-name in query

Request:

Example Request Body (make sure each entry starts on a new line): fabric,vrf,networkName,networkId,networkTemplate,networkExtensionTemplate,networkTemplateConfig fabric1,MyVrf12,MyNetwork12,12,,,

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/bulk-import/vrfs
Request:

Eg Request body: fabric,vrfName,vrfId,vrfTemplate,vrfExtensionTemplate,vrfTemplateConfig ,,,,,{}

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/networks/preview
Return Type:

Changed response : 200 OK

Returns the preview config for the pending (Un)deploy for the networks

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/networks/switches
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/networks/switches/history
POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/networks/{network-name}/deploy
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/networks/{network-name}/status
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/networks/{network-name}/switches/{serial-number}/history
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/networks/{network-name}/switches/{serial-number}/ports
DELETE /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/servicenetworks/{network-name}
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/vrfs/switches/history
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/vrfs/switch-info
Parameters:

Changed: switch-sn in query

Switch Serial no along with VRF name.

GET /appcenter/cisco/ndfc/api/v1/pm/getDBConnectionsData
Return Type:

Changed response : 200 OK

OK

  • New content type : */*

  • Deleted content type : application/JSON

GET /appcenter/cisco/ndfc/api/v1/pm/getPMStatus

Get PM Worker1 Status only, need to obsolete, please use getPMWorkerStatus instead

POST /appcenter/cisco/ndfc/api/v1/pmn/natmodes
Return Type:

Changed response : 500 Internal Server Error

Message varies depending on the condition

  • New content type : text/plain

Changed response : 200 OK

  • New content type : text/plain

Changed response : 401 Unauthorized

Unauthorized access to API

  • New content type : text/plain
POST /appcenter/cisco/ndfc/api/v1/pmn/natrules
Return Type:

Changed response : 500 Internal Server Error

Message varies depending on the condition

  • New content type : text/plain

Changed response : 200 OK

  • New content type : text/plain

Changed response : 401 Unauthorized

Unauthorized access to API

  • New content type : text/plain
GET /appcenter/cisco/ndfc/api/v1/pmn/rtp/fabrics/{fabric-name}/vrfs/{vrf-name}/pathtrace/source/{source}/group/{group}/receiver/{receiver}/switch/{switchNameOrIp}

Fetch the path trace for given source, group, receiver and switch

Parameters:

Added: receiverIPs in query

comma-separated receiver ips

GET /appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/mapInterface/{mapInterface}/egressInterfaces/{egressInterfaces}/maxReplications/{maxReplications}/nategressifmaps
Return Type:

Changed response : 500 Internal Server Error

Message varies depending on the condition

  • New content type : text/plain

Changed response : 401 Unauthorized

Unauthorized access to API

  • New content type : text/plain

Changed response : 200 OK

  • New content type : text/plain
GET /appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/mapInterface/{mapInterface}/egressInterfaces/{egressInterfaces}/maxReplications/{maxReplications}/nategressifmaps/history
Return Type:

Changed response : 500 Internal Server Error

Message varies depending on the condition

  • New content type : text/plain

Changed response : 200 OK

  • New content type : text/plain

Changed response : 401 Unauthorized

Unauthorized access to API

  • New content type : text/plain
PUT /appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/nategressifmaps
Return Type:

Changed response : 200 OK

  • New content type : text/plain

Changed response : 500 Internal Server Error

Message varies depending on the condition

  • New content type : text/plain

Changed response : 401 Unauthorized

Unauthorized access to API

  • New content type : text/plain
POST /appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/nategressifmaps
Return Type:

Changed response : 200 OK

  • New content type : text/plain

Changed response : 500 Internal Server Error

Message varies depending on the condition

  • New content type : text/plain

Changed response : 401 Unauthorized

Unauthorized access to API

  • New content type : text/plain
DELETE /appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/nategressifmaps
Return Type:

Changed response : 500 Internal Server Error

Message varies depending on the condition

  • New content type : text/plain

Changed response : 401 Unauthorized

Unauthorized access to API

  • New content type : text/plain

Changed response : 200 OK

Multicast NAT Recirc Mapping has been successfully deleted by USER_NAME

  • New content type : text/plain
GET /appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/natmodes/vrfs
Return Type:

Changed response : 200 OK

Returns the VRFs list

  • New content type : text/plain

Changed response : 500 Internal Server Error

Invalid parameters provided. Failed to get VRFs

  • New content type : text/plain

Changed response : 401 Unauthorized

Unauthorized access to API

  • New content type : text/plain
GET /appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/natrules/vrfs
Return Type:

Changed response : 200 OK

Returns the VRFs list

  • New content type : text/plain

Changed response : 500 Internal Server Error

Invalid parameters provided. Failed to get VRFs

  • New content type : text/plain

Changed response : 401 Unauthorized

Unauthorized access to API

  • New content type : text/plain
GET /appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/vrfs/{vrf}/groups/{group}/masks/{mask}/modes/{mode}/natmodes/history
Return Type:

Changed response : 500 Internal Server Error

Message varies depending on the condition

  • New content type : text/plain

Changed response : 200 OK

  • New content type : text/plain

Changed response : 401 Unauthorized

Unauthorized access to API

  • New content type : text/plain
GET /appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/vrfs/{vrf}/mapInterface/{mapInterface}/destPrefix/{destPrefix}/maxReplications/{maxReplications}/nategressifmaps
Return Type:

Changed response : 500 Internal Server Error

Message varies depending on the condition

  • New content type : text/plain

Changed response : 200 OK

  • New content type : text/plain

Changed response : 401 Unauthorized

Unauthorized access to API

  • New content type : text/plain
GET /appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/vrfs/{vrf}/mapInterface/{mapInterface}/destPrefix/{destPrefix}/maxReplications/{maxReplications}/nategressifmaps/history
Return Type:

Changed response : 500 Internal Server Error

Message varies depending on the condition

  • New content type : text/plain

Changed response : 200 OK

  • New content type : text/plain

Changed response : 401 Unauthorized

Unauthorized access to API

  • New content type : text/plain
GET /appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/vrfs/{vrf}/mapInterface/{mapInterface}/egressInterfaces/{egressInterfaces}/maxReplications/{maxReplications}/nategressifmaps
Return Type:

Changed response : 500 Internal Server Error

Message varies depending on the condition

  • New content type : text/plain

Changed response : 200 OK

  • New content type : text/plain

Changed response : 401 Unauthorized

Unauthorized access to API

  • New content type : text/plain
GET /appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/vrfs/{vrf}/mapInterface/{mapInterface}/egressInterfaces/{egressInterfaces}/maxReplications/{maxReplications}/nategressifmaps/history
Return Type:

Changed response : 500 Internal Server Error

Message varies depending on the condition

  • New content type : text/plain

Changed response : 200 OK

  • New content type : text/plain

Changed response : 401 Unauthorized

Unauthorized access to API

  • New content type : text/plain
GET /appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/vrfs/{vrf}/modes/{mode}/preTranslationGroups/{preTranslationGroup}/postTranslationGroups/{postTranslationGroup}/preTranslationSources/{preTranslationSource}/postTranslationSources/{postTranslationSource}/groupMasks/{groupMask}/sourceMasks/{sourceMask}/sourcePorts/{sourcePort}/destinationPorts/{destinationPort}/staticOifs/{staticOif}/natrules/history
Return Type:

Changed response : 500 Internal Server Error

Message varies depending on the condition

  • New content type : text/plain

Changed response : 200 OK

  • New content type : text/plain

Changed response : 401 Unauthorized

Unauthorized access to API

  • New content type : text/plain
GET /appcenter/cisco/ndfc/api/v1/ptp/corrections
Parameters:

Deleted: startTimestamp in query

Starting timestamp for time range query

Deleted: endTimestamp in query

Ending timestamp for time range query

Return Type:

Changed response : 200 OK

OK

  • Changed content type : application/json
GET /appcenter/cisco/ndfc/api/v1/ptp/corrections/dates
Return Type:

Changed response : 200 OK

OK

  • Changed content type : application/json
GET /appcenter/cisco/ndfc/api/v1/ptp/fabrics/{fabric-name}/telemetry-sync-status
Return Type:

Changed response : 200 OK

OK

  • Changed content type : application/json
GET /appcenter/cisco/ndfc/api/v1/ptp/parents
Return Type:

Changed response : 200 OK

OK

  • Changed content type : application/json
GET /appcenter/cisco/ndfc/api/v1/ptp/portstatuses
Return Type:

Changed response : 200 OK

OK

  • Changed content type : application/json
GET /appcenter/cisco/ndfc/api/v1/ptp/threshold
Return Type:

Changed response : 200 OK

OK

  • Changed content type : application/json
GET /appcenter/cisco/ndfc/api/v1/ptp/topology
Return Type:

Changed response : 200 OK

OK

  • Changed content type : application/json

    • Deleted property nodeList (array)

    • Deleted property edgeList (array)

POST /appcenter/cisco/ndfc/api/v1/alarm/alarms/clearsourcealarm
GET /appcenter/cisco/ndfc/api/v1/alarm/alarms/scopealarmcategorycount
Parameters:

Added: category in query

Added: switchIp in query

PUT /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/fabricfreezeMode
Parameters:

Changed: fabricName in path

Fabric Name

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/inventory/poap
Parameters:

Changed: fabricName in path

Fabric Name

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/inventory/poap
Parameters:

Changed: fabricName in path

Fabric Name

Request:

Changed content type : application/json

Changed items (object):

  • Added property dhcpBootstrapIP (string)

    DHCP BootstrapIP

  • Added property role (string)

    Role

  • Added property seedSwitch (boolean)

  • Changed property serialNumber (string)

    Serial Numave

  • Changed property model (string)

    Model

  • Changed property version (string)

    Version

  • Changed property hostname (string)

    Hostname

  • Changed property ipAddress (string)

    IP Address

  • Changed property password (string)

    Password

  • Changed property discoveryUsername (string)

    Discovery Username

  • Changed property discoveryPassword (string)

    Discovery Password

  • Changed property discoveryAuthProtocol (integer)

    Discovery AuthProtocol

  • Changed property data (string)

    Data

  • Changed property publicKey (string)

    Public Key

  • Changed property fingerprint (string)

    Fingerprint

  • Changed property imagePolicy (string)

    Image Policy

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/rma
Parameters:

Changed: fabricName in path

Fabric Name

Request:

Changed content type : application/json

  • Changed property oldSerialNumber (string)

    Old Serial Number

  • Changed property newSerialNumber (string)

    New Serial Number

  • Changed property model (string)

    Model

  • Changed property version (string)

    Version

  • Changed property hostname (string)

    Hostname

  • Changed property ipAddress (string)

    IP Address

  • Changed property publicKey (string)

    Public Key

  • Changed property imagePolicy (string)

    Image Policy

  • Changed property password (string)

    Password

  • Changed property discoveryUsername (string)

    Discovery Username

  • Changed property discoveryPassword (string)

    Discovery Password

  • Changed property discoveryAuthProtocol (integer)

    Discovery AuthProtocol

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/links
Request:

Link

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/links/{linkUUID}
Parameters:

Changed: linkUUID in path

LinkUUID

DELETE /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/links/{linkUUID}
Parameters:

Changed: linkUUID in path

LinkUUID

Changed: isLogicalLink in query

isLogicalLink

PUT /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/links/{linkUUID}
Parameters:

Changed: linkUUID in path

LinkUUID

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/policies/switches
Parameters:

Changed: source in query

This is an optional field. Example: UNDERLAY, OVERLAY, loopback0, Ethernet1/5

DELETE /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/policies/switches
Parameters:

Changed: source in query

This is an Mandatory field. Example: UNDERLAY, OVERLAY, loopback0, Ethernet1/5

PUT /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/policies/switches
Parameters:

Changed: source in query

This is an Mandatory field. Example: UNDERLAY, OVERLAY, loopback0, Ethernet1/5

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/policies/switches
Parameters:

Changed: source in query

This is an optional field. Example: UNDERLAY, OVERLAY, loopback0, Ethernet1/5

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/switches/roles
Request:

Changed content type : application/json

Changed items (object):

New required properties:

  • role
  • serialNumber

  • Changed property serialNumber (string)

    Serial Number

  • Canged hproperty role (string)

    Role

    Added enum values:

    • leaf
    • spine
    • super spine
    • border gateway
    • border gateway spine
    • border gateway super spine
    • core router
    • edge router
    • tor
POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/interface/breakout
Request:

Breakout List

Changed content type : application/json

Changed items (object):

New required properties:

  • Interface Name
  • Serial Number

New optional properties:

  • ifName
  • serialNumber

  • Added property Serial Number (string)

    Serial Number

  • Added property Interface Name (string)

    Interface Name

  • Deleted property serialNumber (string)

  • Deleted property ifName (string)

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/interface/deploy
Request:

Changed content type : application/json

Changed items (object):

New required properties:

  • Interface Name
  • Serial Number

New optional properties:

  • ifName
  • serialNumber

  • Added property Serial Number (string)

    Serial Number

  • Added property Interface Name (string)

    Interface Name

  • Deleted property serialNumber (string)

  • Deleted property ifName (string)

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/extension-deploy
Request:

Changed content type : application/json

  • Deleted property errorMessage (string)

  • Deleted property currentState (string)

  • Changed property sourceFabric (string)

    Source Fabric

  • Changed property sourceSwitch (string)

    Source Switch

  • Changed property sourceSwitchSN (string)

    Source SwitchSN

  • Changed property sourcePort (string)

    Source Port

  • Changed property destFabric (string)

    Destination Fabric

  • Changed property destSwitch (string)

    Destination Switch

  • Changed property destSwitchSN (string)

    Destination SwitchSN

  • Changed property destPort (string)

    Destination Port

  • Changed property extensionType (string)

    Extension Type

  • Changed property templateName (string)

    Template Name

  • Changed property templateValues (string)

    Template Values

  • Changed property extensionLayer (string)

    Extension Layer

  • Changed property extensionName (string)

    Extension Name

  • Changed property state (string)

    State

  • Changed property baseTemplateName (string)

    Base Template Name

  • Changed property baseTemplateValues (string)

    Base Template Values

  • Changed property deploymentConfig (string)

    Deployment Config

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/extension-preview
Request:

Changed content type : application/json

  • Deleted property errorMessage (string)

  • Deleted property currentState (string)

  • Changed property sourceFabric (string)

    Source Fabric

  • Changed property sourceSwitch (string)

    Source Switch

  • Changed property sourceSwitchSN (string)

    Source SwitchSN

  • Changed property sourcePort (string)

    Source Port

  • Changed property destFabric (string)

    Destination Fabric

  • Changed property destSwitch (string)

    Destination Switch

  • Changed property destSwitchSN (string)

    Destination SwitchSN

  • Changed property destPort (string)

    Destination Port

  • Changed property extensionType (string)

    Extension Type

  • Changed property templateName (string)

    Template Name

  • Changed property templateValues (string)

    Template Values

  • Changed property extensionLayer (string)

    Extension Layer

  • Changed property extensionName (string)

    Extension Name

  • Changed property state (string)

    State

  • Changed property baseTemplateName (string)

    Base Template Name

  • Changed property baseTemplateValues (string)

    Base Template Values

  • Changed property deploymentConfig (string)

    Deployment Config

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/networks
Parameters:

Added: sort in query

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/networks
Request:

Changed content type : application/json

  • Added property primaryNetworkId (integer)

    Primary Network Id

  • Added property type (string)

    Network Type

    Enum values:

    • Normal
    • Primary
    • Community
    • Isolated

  • Added property hierarchicalKey (string)

  • Changed property fabric (string)

    Fabric Name

  • Changed property networkName (string)

    Network Name

  • Changed property displayName (string)

    Display Name

  • Changed property networkId (integer)

    Network ID

  • Changed property networkTemplate (string)

    Network Template

  • Changed property networkExtensionTemplate (string)

    Network Extension Template

  • Changed property networkTemplateConfig (string)

    Network Template Config

  • Changed property vrf (string)

    VRF

  • Changed property tenantName (string)

    Tenant Name

  • Changed property interfaceGroups (string)

    Interface Groups

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/networks/deployments
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/networks/{network-name}
PUT /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/networks/{network-name}
Request:

Changed content type : application/json

  • Added property primaryNetworkId (integer)

    Primary Network Id

  • Added property type (string)

    Network Type

  • Added property hierarchicalKey (string)

  • Changed property fabric (string)

    Fabric Name

  • Changed property networkName (string)

    Network Name

  • Changed property displayName (string)

    Display Name

  • Changed property networkId (integer)

    Network ID

  • Changed property networkTemplate (string)

    Network Template

  • Changed property networkExtensionTemplate (string)

    Network Extension Template

  • Changed property networkTemplateConfig (string)

    Network Template Config

  • Changed property vrf (string)

    VRF

  • Changed property tenantName (string)

    Tenant Name

  • Changed property interfaceGroups (string)

    Interface Groups

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/networks/{network-name}/attachments
POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/networks/{network-name}/attachments
Request:

Changed content type : application/json

New required properties:

  • deployment
  • dot1QVlan
  • fabric
  • networkName
  • serialNumber
  • switchPorts
  • vlan

  • Added property torPorts (string)

    ToR Ports

  • Changed property fabric (string)

    Fabric Name

  • Changed property networkName (string)

    Network Name

  • Changed property serialNumber (string)

    Serial Number

  • Changed property switchPorts (string)

    Switch Ports

  • Changed property detachSwitchPorts (string)

    Detach Switch Ports

  • Changed property vlan (integer)

    VLAN

  • Changed property dot1QVlan (integer)

    DOT1QVlan

  • Changed property deployment (boolean)

    Deployment

  • Changed property extensionValues (string)

    Extension Values

  • Changed property instanceValues (string)

    Instance Values

  • Changed property freeformConfig (string)

    Freeform config

  • Changed property msoCreated (boolean)

    MSO Created

  • Changed property msoSetVlan (boolean)

    MSO Set Vlan

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/vrfs
Request:

Changed content type : application/json

  • Added property hierarchicalKey (string)

  • Changed property fabric (string)

    Fabric Name

  • Changed property vrfName (string)

    VRF Name

  • Changed property vrfTemplate (string)

    VRF Template

  • Changed property vrfExtensionTemplate (string)

    VRF Extension Template

  • Changed property vrfTemplateConfig (string)

    VRF Template Config

  • Changed property tenantName (string)

    Tenant Name

  • Changed property vrfId (integer)

    VRF ID

  • Changed property serviceVrfTemplate (string)

    Service VRF Template

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/vrfs/deployments
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/vrfs/{vrf-name}
PUT /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/vrfs/{vrf-name}
Request:

Changed content type : application/json

  • Added property hierarchicalKey (string)

  • Changed property fabric (string)

    Fabric Name

  • Changed property vrfName (string)

    VRF Name

  • Changed property vrfTemplate (string)

    VRF Template

  • Changed property vrfExtensionTemplate (string)

    VRF Extension Template

  • Changed property vrfTemplateConfig (string)

    VRF Template Config

  • Changed property tenantName (string)

    Tenant Name

  • Changed property vrfId (integer)

    VRF ID

  • Changed property serviceVrfTemplate (string)

    Service VRF Template

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/networks
Request:

Changed content type : application/json

  • Added property primaryNetworkId (integer)

    Primary Network Id

  • Added property type (string)

    Network Type

  • Added property hierarchicalKey (string)

  • Changed property fabric (string)

    Fabric Name

  • Changed property networkName (string)

    Network Name

  • Changed property displayName (string)

    Display Name

  • Changed property networkId (integer)

    Network ID

  • Changed property networkTemplate (string)

    Network Template

  • Changed property networkExtensionTemplate (string)

    Network Extension Template

  • Changed property vrf (string)

    VRF

  • Changed property tenantName (string)

    Tenant Name

  • Changed property interfaceGroups (string)

    Interface Groups

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/networks/deployments
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/networks/{network-name}
PUT /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/networks/{network-name}
Request:

Changed content type : application/json

  • Added property primaryNetworkId (integer)

    Primary Network Id

  • Added property type (string)

    Network Type

  • Added property hierarchicalKey (string)

  • Changed property fabric (string)

    Fabric Name

  • Changed property networkName (string)

    Network Name

  • Changed property displayName (string)

    Display Name

  • Changed property networkId (integer)

    Network ID

  • Changed property networkTemplate (string)

    Network Template

  • Changed property networkExtensionTemplate (string)

    Network Extension Template

  • Changed property vrf (string)

    VRF

  • Changed property tenantName (string)

    Tenant Name

  • Changed property interfaceGroups (string)

    Interface Groups

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/networks/{network-name}/attachments
POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/networks/{network-name}/attachments
Request:

Changed content type : application/json

New required properties:

  • deployment
  • dot1QVlan
  • fabric
  • networkName
  • serialNumber
  • switchPorts
  • vlan

  • Added property torPorts (string)

    ToR Ports

  • Changed property fabric (string)

    Fabric Name

  • Changed property networkName (string)

    Network Name

  • Changed property serialNumber (string)

    Serial Number

  • Changed property switchPorts (string)

    Switch Ports

  • Changed property detachSwitchPorts (string)

    Detach Switch Ports

  • Changed property vlan (integer)

    VLAN

  • Changed property dot1QVlan (integer)

    DOT1QVlan

  • Changed property deployment (boolean)

    Deployment

  • Changed property extensionValues (string)

    Extension Values

  • Changed property instanceValues (string)

    Instance Values

  • Changed property freeformConfig (string)

    Freeform config

  • Changed property msoCreated (boolean)

    MSO Created

  • Changed property msoSetVlan (boolean)

    MSO Set Vlan

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/vrfs
Request:

Changed content type : application/json

  • Added property hierarchicalKey (string)

  • Changed property fabric (string)

    Fabric Name

  • Changed property vrfName (string)

    VRF Name

  • Changed property vrfTemplate (string)

    VRF Template

  • Changed property vrfExtensionTemplate (string)

    VRF Extension Template

  • Changed property tenantName (string)

    Tenant Name

  • Changed property vrfId (integer)

    VRF ID

  • Changed property serviceVrfTemplate (string)

    Service VRF Template

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/vrfs/deployments
GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/vrfs/{vrf-name}
PUT /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/vrfs/{vrf-name}
Request:

Changed content type : application/json

  • Added property hierarchicalKey (string)

  • Changed property fabric (string)

    Fabric Name

  • Changed property vrfName (string)

    VRF Name

  • Changed property vrfTemplate (string)

    VRF Template

  • Changed property vrfExtensionTemplate (string)

    VRF Extension Template

  • Changed property tenantName (string)

    Tenant Name

  • Changed property vrfId (integer)

    VRF ID

  • Changed property serviceVrfTemplate (string)

    Service VRF Template

POST /appcenter/cisco/ndfc/api/v1/pmn/fabrics/{fabric-name}/vrfs
Parameters:

Changed: addVrfOnly in query

False: add vrf to database and deploy to fabric. True: add vrf to database.

Request:

Changed content type : application/json

  • Added property mode (string)
DELETE /appcenter/cisco/ndfc/api/v1/pmn/fabrics/{fabric-name}/vrfs/{vrf-name}
Parameters:

Changed: deleteVrfOnly in query

False: delete vrf from database and undeploy to fabric. True: delete vrf from database.

PUT /appcenter/cisco/ndfc/api/v1/pmn/fabrics/{fabric-name}/vrfs/{vrf-name}
Request:

Changed content type : application/json

  • Added property mode (string)
POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/control/fabrics/{fabricName}/inventory/discover
Parameters:

Changed: fabricName in path

Fabric Name

Request:

Changed content type : application/json

  • Changed property seedIP (string)

    Seed IP

  • Changed property snmpV3AuthProtocol (integer)

    SNMPV3AuthProtocol

  • Changed property username (string)

    User Name

  • Changed property password (string)

    Password

  • Changed property maxHops (integer)

    Max Hops

  • Changed property cdpSecondTimeout (integer)

    CDP Second Timeout

  • Changed property preserveConfig (boolean)

    Preserve Config

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/interface
DELETE /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/interface
Request:

Changed content type : application/json

Changed items (object):

New required properties:

  • Interface Name
  • Serial Number

New optional properties:

  • ifName
  • serialNumber

  • Added property Serial Number (string)

    Serial Number

  • Added property Interface Name (string)

    Interface Name

  • Deleted property serialNumber (string)

  • Deleted property ifName (string)

PUT /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/interface
Request:

Changed content type : application/json

  • Changed property policy (string)

    Policy

  • Changed property interfaces (array)

    Changed items (object):

    New required properties:

    • Interface Name
    • Serial Number

    New optional properties:

    • ifName
    • serialNumber

    • Added property Serial Number (string)

      Serial Number

    • Added property Interface Name (string)

      Interface Name

    • Deleted property serialNumber (string)

    • Deleted property ifName (string)

    • Changed property nvPairs (object)

      nvPairs

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/interface
Request:

Changed content type : application/json

  • Changed property policy (string)

    Policy

  • Changed property interfaces (array)

    Changed items (object):

    New required properties:

    • Interface Name
    • Serial Number

    New optional properties:

    • ifName
    • serialNumber

    • Added property Serial Number (string)

      Serial Number

    • Added property Interface Name (string)

      Interface Name

    • Deleted property serialNumber (string)

    • Deleted property ifName (string)

    • Changed property nvPairs (object)

      nvPairs

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/interface/adminstatus
Request:

Changed content type : application/json

  • Changed property interfaces (array)

    Changed items (object):

    New required properties:

    • Interface Name
    • Serial Number

    New optional properties:

    • ifName
    • serialNumber

    • Added property Serial Number (string)

      Serial Number

    • Added property Interface Name (string)

      Interface Name

    • Deleted property serialNumber (string)

    • Deleted property ifName (string)

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/networks/attachments
Parameters:

Changed: filter in query

Filter

Changed: sort in query

Sort

Changed: switch-name in query

Switch Name

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/networks/attachments
Request:

Changed content type : application/json

Changed items (object):

  • Changed property networkName (string)

    Network Name

  • Changed property lanAttachList (array)

    Changed items (object):

    New required properties:

    • deployment
    • dot1QVlan
    • fabric
    • networkName
    • serialNumber
    • switchPorts
    • vlan

    • Added property torPorts (string)

      ToR Ports

    • Changed property fabric (string)

      Fabric Name

    • Changed property networkName (string)

      Network Name

    • Changed property serialNumber (string)

      Serial Number

    • Changed property switchPorts (string)

      Switch Ports

    • Changed property detachSwitchPorts (string)

      Detach Switch Ports

    • Changed property vlan (integer)

      VLAN

    • Changed property dot1QVlan (integer)

      DOT1QVlan

    • Changed property deployment (boolean)

      Deployment

    • Changed property extensionValues (string)

      Extension Values

    • Changed property instanceValues (string)

      Instance Values

    • Changed property freeformConfig (string)

      Freeform config

    • Changed property msoCreated (boolean)

      MSO Created

    • Changed property msoSetVlan (boolean)

      MSO Set Vlan

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/vrfs/attachments
Parameters:

Added: Range in header

Added: filter in query

Added: sort in query

POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/fabrics/{fabric-name}/vrfs/attachments

Attach/Detach VRFs/VRF-Lite

Request:

List of LAN Attach objects.When in Lan Attach object deployment:true it's attach and when deployment:false it's detach.

Changed content type : application/json

Changed items (object):

  • Changed property lanAttachList (array)

    Changed items (object):

    • Changed property fabric (string)

      Fabric

    • Changed property vrfName (string)

      VRF Name

    • Changed property serialNumber (string)

      Serial Number

    • Changed property vlan (integer)

      VLAN

    • Changed property deployment (boolean)

      Deployment

    • Changed property extensionValues (string)

      Extension Value

    • Changed property instanceValues (string)

      Instance Value

    • Changed property freeformConfig (string)

      Freeform Config

    • Changed property msoCreated (boolean)

      MSO Created

    • Changed property msoSetVlan (boolean)

      MSO Set Vlan

Return Type:

Changed response : 200 OK

Attach/Detach saving the VRFs to switch is successful

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/networks/attachments
POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/networks/attachments
Request:

Changed content type : application/json

Changed items (object):

  • Changed property networkName (string)

    Network Name

  • Changed property lanAttachList (array)

    Changed items (object):

    New required properties:

    • deployment
    • dot1QVlan
    • fabric
    • networkName
    • serialNumber
    • switchPorts
    • vlan

    • Added property torPorts (string)

      ToR Ports

    • Changed property fabric (string)

      Fabric Name

    • Changed property networkName (string)

      Network Name

    • Changed property serialNumber (string)

      Serial Number

    • Changed property switchPorts (string)

      Switch Ports

    • Changed property detachSwitchPorts (string)

      Detach Switch Ports

    • Changed property vlan (integer)

      VLAN

    • Changed property dot1QVlan (integer)

      DOT1QVlan

    • Changed property deployment (boolean)

      Deployment

    • Changed property extensionValues (string)

      Extension Values

    • Changed property instanceValues (string)

      Instance Values

    • Changed property freeformConfig (string)

      Freeform config

    • Changed property msoCreated (boolean)

      MSO Created

    • Changed property msoSetVlan (boolean)

      MSO Set Vlan

GET /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/vrfs/attachments
POST /appcenter/cisco/ndfc/api/v1/lan-fabric/rest/top-down/v2/fabrics/{fabric-name}/vrfs/attachments
Request:

Changed content type : application/json

Changed items (object):

  • Changed property lanAttachList (array)

    Changed items (object):

    • Changed property fabric (string)

      Fabric

    • Changed property vrfName (string)

      VRF Name

    • Changed property serialNumber (string)

      Serial Number

    • Changed property vlan (integer)

      VLAN

    • Changed property deployment (boolean)

      Deployment

    • Changed property extensionValues (string)

      Extension Value

    • Changed property instanceValues (string)

      Instance Value

    • Changed property freeformConfig (string)

      Freeform Config

    • Changed property msoCreated (boolean)

      MSO Created

    • Changed property msoSetVlan (boolean)

      MSO Set Vlan

Release 12.1.1 (2022-06-03)

For additional information about the release, see the Release Notes.

Added the following new APIs:

/appcenter/cisco/ndfc/api/v1/elastic-service/fabrics/{fabric-name}/service-nodes/{node-name}/peerings/{attached-fabric}/{peering-name}/policies - Retrieve and delete service policies of the selected service node and peering

/appcenter/cisco/ndfc/api/v1/license-manager/license/getLicenseAssigmentInfo - Get switch assigned license details for all switches

/appcenter/cisco/ndfc/api/v1/license-manager/license/getSwitchAssignedLicenseInfo - Get the switch assigned license details

/appcenter/cisco/ndfc/api/v1/pm/isFabricInPmCollection - Check if fabric is in PM collection by fabricDbId

/appcenter/cisco/ndfc/api/v1/pmn/fabrics/{fabricName}/vrfs/{vrfName}/flowstatus/{multicast-IP}/{sender-IP}/{receiver-IP} - Get the status of all established/inactive flows in a network

/appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/vrfs/{vrf}/groups/{group}/masks/{mask}/modes/{mode}/natmodes/history - Get deployment history for a given NAT mode on a switch

/appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/vrfs/{vrf}/mapInterface/{mapInterface}/destPrefix/{destPrefix}/maxReplications/{maxReplications}/nategressifmaps - Get a Multicast NAT Recirc Mappings Destination/Prefix object given a destination/prefix (Multicast-Unicast or Unicast-Multicast NAT) on a given switch and a given VRF

/appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/vrfs/{vrf}/mapInterface/{mapInterface}/destPrefix/{destPrefix}/maxReplications/{maxReplications}/nategressifmaps/history - Get deployment history for a Recirc Mappings Destination/Prefix object on a given switch and a given VRF

/appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/vrfs/{vrf}/mapInterface/{mapInterface}/egressInterfaces/{egressInterfaces}/maxReplications/{maxReplications}/nategressifmaps - Get a Multicast NAT Recirc Mappings object given a list of egress interfaces (Multicast-Multicast NAT) in the given switch and VRF

/appcenter/cisco/ndfc/api/v1/pmn/switches/{switchNameOrIP}/vrfs/{vrf}/mapInterface/{mapInterface}/egressInterfaces/{egressInterfaces}/maxReplications/{maxReplications}/nategressifmaps/history - Get deployment history for a given NAT Recirc Mappings Egress Interface object on a given switch and a given VRF

/appcenter/cisco/ndfc/api/v1/ptp/topology - Get PTP topology

/appcenter/cisco/ndfc/api/v1/vmm/about - Get VMM information

/appcenter/cisco/ndfc/api/v1/vmm/inventory/getVHostDetail - Get vCenters details

/appcenter/cisco/ndfc/api/v1/vmm/vmm/addVirtualCenter - Add a vCenter

/appcenter/cisco/ndfc/api/v1/vmm/vmm/getVirtualCenters - Get vCenters

Release 12.0.2 (2021-12-17)

For additional information about the release, see the Release Notes.

First release of Nexus Dashboard Fabric Controller API integrated into Nexus Dashboard platform.