Cisco APIC Getting Started Guide, Release 6.2(x)

PDF

Register an unregistered switch using the REST API

Updated: January 12, 2026

Overview

Use this procedure to register a switch from theNodes Pending Registration tab on the Fabric Membership work pane using the REST API. This process ensures that the system checks for the node's existence and registers it if it is not already present.

Use this procedure to register a switch from the Nodes Pending Registration tab on the Fabric Membership work pane using the REST API.

Note
This procedure is identical to "Adding a Switch Before Discovery Using the REST API". When you apply the code, the system determines if the node exists and, if not, adds it. If the node does exist, the system registers it.

Procedure

Add a switch description.

Example:

POST
                        https://<IP address>/api/policymgr/mo/uni.xml
                        <!-- /api/policymgr/mo/uni.xml -->
                        <polUni>
                        <ctrlrInst>
                        <fabricNodeIdentPol>
                        <fabricNodeIdentP  nodeType="tier-2-leaf" podId="1" serial="XXXXXXXXX"
                        name="tier-2-leaf-leaf1" nodeId="101"/>
                        </fabricNodeIdentPol>
                        </ctrlrInst>
                        </polUni>