Get Upgrade Manager Status
Retrieves real-time status and detailed progress information for the Upgrade Manager upgrade operation. This endpoint provides visibility into upgrade execution with granular reporting for each upgrade step and an overall progress percentage.
Poll this endpoint at regular intervals while upgrade is in progress.
Upon completion, verify that overall_status is SUCCESS before proceeding with appliance upgrade (POST /upgrade). If status is FAILED, examine the upgrade_steps array for the failed step to identify root cause.
If no Upgrade Manager upgrade has been initiated, the response indicates NOT_STARTED status with progress_percentage of 0.
Upgrade Manager status retrieved successfully. The response contains the overall upgrade status, progress percentage, and detailed progress information for each upgrade step.
{
"overall_status": "string",
"upgrade_steps": [
{
"_create_time": 0,
"_last_modified_time": 0,
"id": "string",
"display_name": "string",
"description": "string",
"activity_status_msg": "string",
"_completed_at": 0,
"status": "string",
"messages": [
{
"severity": "string",
"message": "string"
}
],
"last_run_time": 0
}
],
"progress_percentage": 0,
"current_step": "string"
}
Execution state of an operation.
Ordered sequence of all Upgrade Manager upgrade steps with their individual execution status and messages. Steps are listed in the order they are executed.
Overall progress of the Upgrade Manager upgrade as a percentage (0-100). This is calculated based on the number of completed steps.
Name of the upgrade step currently being executed. This field is only present when the upgrade is in progress (overall_status is IN_PROGRESS).
Bad Request
{
"error_code": 0,
"module_name": "string",
"error_message": "string"
}
HTTP Status or Application error code.
Module where the error happened.
Message describing the error.
Unauthorized
{
"error_code": 0,
"module_name": "string",
"error_message": "string"
}
HTTP Status or Application error code.
Module where the error happened.
Message describing the error.
Forbidden
{
"error_code": 0,
"module_name": "string",
"error_message": "string"
}
HTTP Status or Application error code.
Module where the error happened.
Message describing the error.
Precondition Failed
{
"error_code": 0,
"module_name": "string",
"error_message": "string"
}
HTTP Status or Application error code.
Module where the error happened.
Message describing the error.
Precondition Required
{
"error_code": 0,
"module_name": "string",
"error_message": "string"
}
HTTP Status or Application error code.
Module where the error happened.
Message describing the error.
Too Many Requests
{
"error_code": 0,
"module_name": "string",
"error_message": "string"
}
HTTP Status or Application error code.
Module where the error happened.
Message describing the error.
Unexpected error occurred while retrieving upgrade status. Consult the error response details and system logs for diagnostic information.
{
"error_code": 0,
"module_name": "string",
"error_message": "string"
}
HTTP Status or Application error code.
Module where the error happened.
Message describing the error.
curl -H 'Authorization: <value>' https://{api_host}/https://{api_host}:{port}/lh-appliance/upgrade/manager/status