The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
The Cisco Fabric Automation REST APIs for third party applications enables you to programmatically control Cisco Fabric Automation. The REST API supports POAP (Power On Auto Provisioning), Auto Config and Cable plan features.
POAP allows devices to boot up with temporary IP address (assigned by DHCP server), to download the POAP boot-up script (also assigned by DHCP server) which will further download the required kick-start and system image, and the device configuration file from the specific TFTP server indicated in the boot-up script.
In the Cisco Fabric Automation architecture, the virtual machine (VM) facing interface on leaf switches is automatically configured and de-configured by the auto config. It detects the server/VM boot-up, retrieves pre-defined network parameters from the asset database, and applies the generated configuration. When the VM is moved or shutdown, the auto config also updates/removes the dynamic configuration.
Cable plan provides a Netmap of port-to-port cable connectivity data that can be imported into the switches of the Fabric Automation. The XML cable plan acts as a lookup table, and if a port is not connected to its corresponding destination port as per the plan, the switch should flag an error and notify the customers.
All the REST API operations can also be performed using the DCNM GUI as DCNM uses these REST APIs to render the GUI.
For more information about Cisco Dynamic Fabric Automation, see the Cisco DFA Application Programmer’s Guide.
In a Fabric Automation datacenter, Cisco DCNM will be the central point of management for the fabric and for the network auto-configuration. PoAP templates are used to auto-configure the spine and leaf network devices and configuration profiles are used to auto-configure the organizations, networks and services.
DCNM works as the network controller in conjunction with any instances of compute/storage orchestrators and service controllers to provide an open and extensible integrated virtual and physical network. Organizations and networks can be created directly using the Cisco DCNM GUIs or through the compute/storage orchestrators. In both cases the external APIs discussed in this document are used to retrieve information and create/retrieve/update/delete configuration profile instances into the network Asset Database (LDAP). The leaf devices in turn fetch configuration from the Asset Database and self-configure themselves. Service controllers like PNSC can also get organization/network information from DCNM through the APIs, as well as update the configuration profiles for services integration.
The general workflow is as follows:
Throughout this process the network and network services can be automated using Fabric Automation. For an animated description of the Fabric Automation architecture and work flow refer the following link https://www.youtube.com/watch?v=MNnv2Y_k6EY.
Note You can also use your own REST based clients to integrate with third party orchestrators.
DCNM will provide REST API, and the REST approach emphasizes on using the resource name as part of the URL. In this release, the response of the REST API will be encoded in JSON format (see https://www.json.org for validation).
The query parameters for the https GET will be appended to the URL after the symbol “?”; the input for the https POST/PUT/DELETE will be specified in the payload with the URL-encoded. REST APIs support both https and https.
This section contains the high level description for the REST API, during implementation the REST APIs are subject to change.
DCNM REST API supports “application/json” for the Content-Type.
The following parameter types are mentioned in this document: