NSX-T Data Center REST API

Associated URIs:

API Description	API Path
Get upgrade task status Get upgrade task status for the given task of the given bundle. Both bundle_name and task_id must be provided, otherwise you will receive a 404 NOT FOUND response. This api is deprecated. Please use API GET /node/upgrade/status-summary to get upgrade status when upgrade is in progress.	GET /api/v1/cluster/<cluster-node-id>/node/upgrade (Deprecated) GET /api/v1/node/upgrade (Deprecated)
Execute upgrade task Execute upgrade task.	POST /api/v1/node/upgrade/performtask POST /api/v1/cluster/<cluster-node-id>/node/upgrade/performtask
Get upgrade progress status Get progress status of last upgrade step, if upgrade bundle is present.	GET /api/v1/node/upgrade/progress-status GET /api/v1/cluster/<cluster-node-id>/node/upgrade/progress-status
Get upgrade status summary Get status summary of node upgrade, if upgrade bundle is present.	GET /api/v1/cluster/<cluster-node-id>/node/upgrade/status-summary GET /api/v1/node/upgrade/status-summary
Triggers Repository driven Uc Upgrade Triggers repository driven uc upgrade on the node. This API expects that repository is synced across nodes before starting upgrade.	POST /api/v1/node/upgrade/uc POST /api/v1/cluster/<cluster-node-id>/node/upgrade/uc
Upgrade the upgrade coordinator. Upgrade the upgrade coordinator module itself. This call is invoked after user uploads an upgrade bundle. Once this call is invoked, upgrade coordinator stops and gets restarted and target version upgrade coordinator module comes up after restart.	POST /api/v1/upgrade?action=upgrade_uc
Abort pre-upgrade checks Aborts execution of pre-upgrade checks if already in progress. Halts the execution of checks awaiting execution at this point and makes best-effort attempts to stop checks already in execution. Returns without action if execution of pre-upgrade checks is not in progress.	POST /api/v1/upgrade?action=abort_pre_upgrade_checks
Execute pre-upgrade checks Run pre-defined checks to identify potential issues which can be encountered during an upgrade or can cause an upgrade to fail. The results of the checks are added to the respective upgrade units aggregate-info. The progress and status of operation is part of upgrade status summary of individual components. Returns HTTP status 500 with error code 30953 if execution of pre-upgrade checks is already in progress.	POST /api/v1/upgrade?action=execute_pre_upgrade_checks
Execute post-upgrade checks Run pre-defined checks to identify issues after upgrade of a component. The results of the checks are added to the respective upgrade units aggregate-info. The progress and status of post-upgrade checks is part of aggregate-info of individual upgrade unit groups. Returns HTTP status 500 with error code 30953 if execution of post-upgrade checks is already in progress.	POST /api/v1/upgrade/<component-type>?action=execute_post_upgrade_checks
Upload upgrade bundle Upload the upgrade bundle. The call returns after upload is initiated. User needs to check upload status periodically by retrieving upgrade bundle upload status to find out if the upload is completed. This API is deprecated, please use /upgrade/bundles?action=upload API to upload the upgrade bundle.	POST /api/v1/upgrade/bundle?action=upload (Deprecated)
Upload upgrade bundle Upload the upgrade bundle. This call returns after upload is completed. You can check bundle processing status periodically by retrieving upgrade bundle upload status to find out if the upload and processing is completed.	POST /api/v1/upgrade/bundles?action=upload
Fetch upgrade bundle from given url Fetches the upgrade bundle from url. The call returns after fetch is initiated. Check status by periodically retrieving upgrade bundle upload status using GET /upgrade/bundles/<bundle-id>/upload-status. The upload is complete when the status is SUCCESS.	POST /api/v1/upgrade/bundles
Get uploaded upgrade bundle information Get uploaded upgrade bundle information	GET /api/v1/upgrade/bundles/<bundle-id>
Cancel upgrade bundle upload Cancel upload of upgrade bundle. This API works only when bundle upload is in-progress and will not work during post-processing of upgrade bundle. If bundle upload is in-progress, then the API call returns http OK response after cancelling the upload and deleting partially uploaded bundle.	POST /api/v1/upgrade/bundles/<bundle-id>?action=cancel_upload
Get uploaded upgrade bundle upload status Get uploaded upgrade bundle upload status	GET /api/v1/upgrade/bundles/<bundle-id>/upload-status
Accept end user license agreement Accept end user license agreement	POST /api/v1/upgrade/eula/accept
Return the acceptance status of end user license agreement Return the acceptance status of end user license agreement	GET /api/v1/upgrade/eula/acceptance
Return the content of end user license agreement Return the content of end user license agreement in the specified format. By default, it's pure string without line break	GET /api/v1/upgrade/eula/content
Get functional state of the upgrade coordinator Get the functional state of the upgrade coordinator.	GET /api/v1/upgrade/functional-state
Get upgrade history Get upgrade history	GET /api/v1/upgrade/history
Get list of nodes across all types Get list of nodes. If request parameter component type is specified, then all nodes for that component will be returned. If request parameter component version is specified, then all nodes at that version will be returned.	GET /api/v1/upgrade/nodes
Get summary of nodes Get summary of nodes, which includes node count for each type and component version.	GET /api/v1/upgrade/nodes-summary
Upgrade selected units Upgrades, Resumes the upgrade of a selected set of units.	POST /api/v1/upgrade/plan?action=upgrade_selected_units
Stage the upgrade bits This will stage the upgrade bits so that upgrade can be driven from outside NSX upgrade-coordinator. If component type is not provided as a request parameter then upgrade staging will be performed on all the components.	POST /api/v1/upgrade/plan?action=stage-upgrade
Start upgrade Start the upgrade. Upgrade will start as per the upgrade plan.	POST /api/v1/upgrade/plan?action=start
Pause upgrade Pause the upgrade. Upgrade will be paused after upgrade of all the nodes currently in progress is completed either successfully or with failure. User can make changes in the upgrade plan when the upgrade is paused.	POST /api/v1/upgrade/plan?action=pause
Reset upgrade plan to default plan Reset the upgrade plan to default plan. User has an option to change the default plan. But if after making changes, user wants to go back to the default plan, this is the way to do so.	POST /api/v1/upgrade/plan?action=reset
Continue upgrade Continue the upgrade. Resumes the upgrade from the point where it was paused.	POST /api/v1/upgrade/plan?action=continue
Get upgrade plan settings for the component Get the upgrade plan settings for the component.	GET /api/v1/upgrade/plan/<component_type>/settings
Update upgrade plan settings for the component Update the upgrade plan settings for the component.	PUT /api/v1/upgrade/plan/<component_type>/settings
Returns pre-upgrade checks in csv format Returns pre-upgrade checks in csv format	GET /api/v1/upgrade/pre-upgrade-checks?format=csv
Get Pre-upgrade Check Failures Get failures resulting from the last execution of pre-upgrade checks. If the execution of checks is in progress, the response has the list of failures observed so far.	GET /api/v1/upgrade/pre-upgrade-checks/failures
Get upgrade status summary Get upgrade status summary	GET /api/v1/upgrade/status-summary
Get upgrade summary Get upgrade summary	GET /api/v1/upgrade/summary
Get upgrade-coordinator upgrade status Get upgrade-coordinator upgrade status	GET /api/v1/upgrade/uc-upgrade-status
Returns information about upgrade checks Returns information of pre-upgrade and post-upgrade checks. If request parameter component type is specified, then returns information about all pre-upgrade and post-upgrade for the component. Otherwise returns information of checks across all component types.	GET /api/v1/upgrade/upgrade-checks-info
Return information of all upgrade unit groups Return information of all upgrade unit groups in the upgrade plan. If request parameter summary is set to true, then only count of upgrade units will be returned, upgrade units list will be empty. If request parameter component type is specified, then all upgrade unit groups for that component will be returned.	GET /api/v1/upgrade/upgrade-unit-groups
Create a group Create a group of upgrade units.	POST /api/v1/upgrade/upgrade-unit-groups
Get upgrade status for upgrade unit groups Get upgrade status for upgrade unit groups	GET /api/v1/upgrade/upgrade-unit-groups-status
Delete the upgrade unit group Delete the specified group. NOTE - A group can be deleted only if it is empty. If user tries to delete a group containing one or more upgrade units, the operation will fail and an error will be returned.	DELETE /api/v1/upgrade/upgrade-unit-groups/<group-id>
Return upgrade unit group information Returns information about a specific upgrade unit group in the upgrade plan. If request parameter summary is set to true, then only count of upgrade units will be returned, upgrade units list will be empty.	GET /api/v1/upgrade/upgrade-unit-groups/<group-id>
Add upgrade units to specified upgrade unit group Add upgrade units to specified upgrade unit group. The upgrade units will be added at the end of the upgrade unit list.	POST /api/v1/upgrade/upgrade-unit-groups/<group-id>?action=add_upgrade_units
Reorder upgrade unit group Reorder an upgrade unit group by placing it before/after the specified upgrade unit group.	POST /api/v1/upgrade/upgrade-unit-groups/<group-id>?action=reorder
Update the upgrade unit group Update the specified upgrade unit group. Removal of upgrade units from the group using this is not allowed. An error will be returned in that case.	PUT /api/v1/upgrade/upgrade-unit-groups/<group-id>
Get upgrade status for group Get upgrade status for upgrade units in the specified group. User can specify whether to show only the upgrade units with errors.	GET /api/v1/upgrade/upgrade-unit-groups/<group-id>/status
Reorder an upgrade unit within the upgrade unit group Reorder an upgrade unit within the upgrade unit group by placing it before/after the specified upgrade unit	POST /api/v1/upgrade/upgrade-unit-groups/<group-id>/upgrade-unit/<upgrade-unit-id>?action=reorder
Return aggregate information of all upgrade unit groups Return information of all upgrade unit groups in the upgrade plan. If request parameter summary is set to true, then only count of upgrade units will be returned, upgrade units list will be empty. If request parameter component type is specified, then all upgrade unit groups for that component will be returned.	GET /api/v1/upgrade/upgrade-unit-groups/aggregate-info
Get upgrade units Get upgrade units	GET /api/v1/upgrade/upgrade-units
Get upgrade units stats Get upgrade units stats	GET /api/v1/upgrade/upgrade-units-stats
Get a specific upgrade unit Get a specific upgrade unit	GET /api/v1/upgrade/upgrade-units/<upgrade-unit-id>
Get upgrade units aggregate-info Get upgrade units aggregate-info	GET /api/v1/upgrade/upgrade-units/aggregate-info
Get the version whitelist Get whitelist of versions for different components	GET /policy/api/v1/upgrade/version-whitelist GET /api/v1/upgrade/version-whitelist
Get the version whitelist for the specified component Get whitelist of versions for a component. Component can include HOST, EDGE, CCP, MP	GET /policy/api/v1/upgrade/version-whitelist/<component_type> GET /api/v1/upgrade/version-whitelist/<component_type>
Update the version whitelist for the specified component type Update the version whitelist for the specified component type (HOST, EDGE, CCP, MP).	PUT /policy/api/v1/upgrade/version-whitelist/<component_type> PUT /api/v1/upgrade/version-whitelist/<component_type>