Cisco APIC Getting Started Guide, Release 6.2(x)

Remove a switch to maintenance mode using the REST API

Updated: January 12, 2026

Want to summarize with AI?

Use this procedure to remove a switch to maintenance mode by sending a POST request to the specified API endpoint with the necessary parameters to decommission the node.

Procedure

Remove a switch to maintenance mode.

Example:

POST
                        https://<IP address>/api/node/mo/uni/fabric/outofsvc.xml
                        <fabricOOServicePol 
                        descr="" 
                        dn="" 
                        name="default" 
                        nameAlias="" 
                        ownerKey="" 
                        ownerTag="">
                        <fabricRsDecommissionNode 
                        debug="yes" 
                        dn="" 
                        removeFromController="no" 
                        tDn="topology/pod-1/node-102"/>
                        </fabricOOServicePol>

Need help?

Open a support case

(Requires a Cisco Service Contract)

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.