Cisco APIC Installation and ACI Upgrade and Downgrade Guide

PDF

Cisco APIC Installation and ACI Upgrade and Downgrade Guide

REST API switch upgrade scheduler pause verification

Updated: July 12, 2026

Want to summarize with AI?

Log in

Provides the API method to verify whether a switch upgrade scheduler is paused in a maintenance policy.

The REST API method allows verification of whether a scheduler is paused for a switch maintenance policy by posting a specific API endpoint and examining the returned XML response.

API endpoint and usage

Post the following API to verify that a scheduler is paused for a switch maintenance policy:

https://<ip address>/api/node/class/maintUpgStatus.xml

The API returns XML data showing maintenance upgrade status information for controller groups and switch groups.

Response format and interpretation

The API response includes the following key elements:

  • ConstCtrlrMaintP: Represents the controller group

  • Nowgrp: Represents a switch group

  • runStatus attribute: Indicates whether the scheduler is "paused" or "running"

https://<ip address>/api/node/class/maintUpgStatus.xml

ConstCtrlrMaintP ==> controller group
Nowgrp ===> A switch group

<?xml version="1.0" encoding="UTF-8"?>
<imdata totalCount="2">
    <maintUpgStatus childAction="" dn="maintupgstatuscont/maintupgstatus-ConstCtrlrMaintP" faultDelegateKey="uni/
fabric/maintpol-ConstCtrlrMaintP" lcOwn="local" maxConcurrent="0" modTs="2014-08-28T14:45:24.232-07:00" 
polName="ConstCtrlrMaintP" runStatus="paused" status="" uid="0" waitOnClusterHealth="no" windowName=""/>
    <maintUpgStatus childAction="" dn="maintupgstatuscont/maintupgstatus-nowgrp" faultDelegateKey="" lcOwn="
local" maxConcurrent="0" modTs="2014-08-28T08:05:15.148-07:00" polName="nowgrp" runStatus="running" status="" 
uid="0" waitOnClusterHealth="no" windowName=""/>
</imdata>