Provides examples for managing switch firmware and maintenance policies using API requests. These examples assist administrators in automating switch upgrades and monitoring status.
This topic provides API request examples for configuring switch firmware groups, maintenance policies, and retrieving upgrade status information.
Switch Firmware Group – Group of switches with same firmware policy
POST URL: http://trunk6-ifc1/api/node/mo/uni/fabric.xml
<firmwareFwGrp name="AllswitchesFwGrp" >
<fabricNodeBlk name="Blk101to104” from_="101" to_="104” />
<firmwareRsFwgrpp tnFirmwareFwPName="AllswitchesFwP” />
</firmwareFwGrp>
Switch Firmware Firmware Policy – Set desired version
POST URL: http://trunk6-ifc1/api/node/mo/fabric.xml
<firmwareFwP name="AllswitchesFwP” version="n9000-11.0(0.775)” ignoreCompat="true">
</firmwareFwP>
Switch Maintenance Group – Group of switches with same maintenance policy
POST URL: http://trunk6-ifc1/api/node/mo/uni/fabric.xml
<maintMaintGrp name="AllswitchesMaintGrp">
<fabricNodeBlk name="Blk101to104” from_="101" to_="104” />
<maintRsMgrpp tnMaintMaintPName="AllswitchesMaintP” />
</maintMaintGrp>
Switch Maintenance Policy – Setup schedule for maitenance
POST URL: http://trunk6-ifc1/api/node/mo/uni/fabric.xml
<maintMaintP name="AllswitchesMaintP” runMode="pauseOnlyOnFailures" >
</maintMaintP>
Trigger upgrade on Maintenance Group – starting now
POST URL: http://trunk6-ifc1/api/node/mo/uni/fabric.xml
<maintMaintP name="AllswitchesMaintP" adminSt="triggered">
</maintMaintP>
Get current running version on switches
(all switches) GET UR : http://trunk6-ifc1.insieme.local/api/node/class/firmwareRunning.xml
(a switch) GET URL: http://trunk6-ifc1.insieme.local/api/node/mo/topology/pod-1/node-101/sys/fwstatuscont/running.xml
Get upgrade status of switches
(all switches) GET URL: http://trunk6-ifc1.insieme.local/api/node/class/maintUpgJob.xml
(a switch) GET URL: http://trunk6-ifc1.insieme.local/api/node/mo/topology/pod-1/node-101/sys/fwstatuscont/upgjob.xml