Cisco APIC Installation and ACI Upgrade and Downgrade Guide

PDF

Cisco APIC Installation and ACI Upgrade and Downgrade Guide

Switch software maintenance upgrade patch installation and uninstallation using the REST API

Updated: July 12, 2026

Want to summarize with AI?

Log in

Provides REST API XML examples and parameter descriptions for installing or uninstalling software maintenance upgrade patches on switches.

The following example REST API XML installs a software maintenance upgrade (SMU) patch on a switch and reboots the switch after the installation completes:

<polUni>
    <fabricInst>
        <maintMaintP
          version="n9000-patch-CSCsysinfo12-15.2.0.151-S1.1.1.x86_64"
          smuOperation="smuInstall"
          smuOperationFlags="smuReloadImmediate"
          name="Leaf202"
          adminSt="triggered">
        </maintMaintP>

        <maintMaintGrp name="Leaf202">
            <fabricNodeBlk name="blk202" from_="202" to_="202">
            </fabricNodeBlk>
            <maintRsMgrpp tnMaintMaintPName="Leaf202">
            </maintRsMgrpp>
        </maintMaintGrp>
    </fabricInst>
</polUni>

By changing some of the parameter values as specified in the table, you can specify whether to install or uninstall a patch, and you can specify not to reboot the switches after a patch is installed or uninstalled.

SMU patch elements and parameters

The following table explains the elements and parameters that are specific to SMU patches:

Element

Parameter

Descripiton

maintMaintP

version

Specifies the filename of the SMU patch.

maintMaintP

smuOperation

Specifies whether to install or uninstall the patch. The possible values are:

  • smuInstall: Install the patch.

  • smuUninstall: Uninstall the patch.

maintMaintP

smuOperationFlags

Specifies whether to reboot the switch after the patch is installed. The possible values are:

  • smuReloadImmediate: The switches are rebooted after the SMU patch gets installed. Specify this value if you want to install only one SMU patch, or if you are installing the final patch of multiple patches.

  • smuReloadSkip: The switches are not rebooted after the SMU patch gets installed. Specify this value if you want to install multiple SMU patches and this patch is not the final patch. In this case, post the appropriate XML for each additional patch and continue to specify smuReloadSkip until you are installing the final patch. For the final patch, specify smuReloadImmediate. Optionally, you can specify smuReloadSkip and manually reboot the switch after the patch gets installed.

maintMaintP

name

Specifies the name of the maintenance group.

fabricNodeBlk

from_ and to_

Specifies the range of switch node IDs on which to install or from which to uninstall the patch.

maintRsMgrpp

tnMaintMaintPName

Specifies the name of the maintenance group. The value must match the value of the name parameter of the maintMaintP element.