GET /upgradestatusinfo

GET /upgradestatusinfo

/upgradestatusinfo

Request
URI
GET
https://{api_host}/api/upgradestatusinfo
COPY
Query Parameters
string
name
Optional

object name

string
refers_to
Optional

Filter to request all objects that refers to another Avi resource. Its syntax is refers_to= : . Eg. get all virtual services referring to pool p1 will be refers_to=pool:pool_p1_uuid

string
referred_by
Optional

Filter to request all objects that are referred by another Avi resource. Its syntax is referred_by= : . Eg. get all pools referred_by virtual service vs1 - referred_by=virtualservice:vs_vs1_uuid

string
fields
Optional

List of fields to be returned for the resource. Some fields like name, URL, uuid etc. are always returned.

boolean
include_name
Optional

All the Avi REST reference URIs have a name suffix as URI#name. It is useful to get the referenced resource name without performing get on that object.

boolean
skip_default
Optional

Default values are not set.

string
join_subresources
Optional

It automatically returns additional dependent resources like runtime. Eg. join_subresources=runtime.

Header Parameters
string
X-Avi-Tenant
Optional

Avi Tenant Header

string
X-Avi-Tenant-UUID
Optional

Avi Tenant Header UUID

string
X-Avi-Version
Required

The caller is required to set Avi Version Header to the expected version of configuration. The response from the controller will provide and accept data according to the specified version. The controller will reject POST and PUT requests where the data is not compatible with the specified version.

string
X-CSRFToken
Optional

Avi Controller may send back CSRF token in the response cookies. The caller should update the request headers with this token else controller will reject requests.


Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns UpgradeStatusInfoApiResponse of type(s) application/json
{
    "count": 0,
    "results": [
        {
            "_last_modified": "string",
            "after_reboot_rollback_fnc": "string",
            "after_reboot_task_name": "string",
            "clean": false,
            "dryrun_info": {
                "duration": 0,
                "end_time": "string",
                "operation": "string",
                "params": {
                    "controller_patch_ref": "string",
                    "dryrun": false,
                    "image_ref": "string",
                    "prechecks_only": false,
                    "se_group_options": {
                        "action_on_error": "string",
                        "disruptive": false
                    },
                    "se_group_refs": [
                        "string"
                    ],
                    "se_patch_ref": "string",
                    "skip_warnings": false,
                    "system": false
                },
                "progress": 0,
                "start_time": "string",
                "state": {
                    "last_changed_time": {
                        "secs": 0,
                        "usecs": 0
                    },
                    "reason": "string",
                    "rebooted": false,
                    "state": "string"
                },
                "tasks_completed": 0,
                "total_tasks": 0,
                "upgrade_events": [
                    {
                        "nodes_events": [
                            {
                                "duration": 0,
                                "end_time": "string",
                                "ip": {
                                    "addr": "string",
                                    "type": "string"
                                },
                                "message": "string",
                                "start_time": "string",
                                "status": false,
                                "sub_tasks": [
                                    "string"
                                ]
                            }
                        ],
                        "sub_events": [
                            {
                                "duration": 0,
                                "end_time": "string",
                                "ip": {
                                    "addr": "string",
                                    "type": "string"
                                },
                                "message": "string",
                                "start_time": "string",
                                "status": false,
                                "sub_tasks": [
                                    "string"
                                ]
                            }
                        ],
                        "task": "string",
                        "task_name": "string"
                    }
                ],
                "worker": "string"
            },
            "duration": 0,
            "enable_patch_rollback": false,
            "enable_rollback": false,
            "end_time": "string",
            "enqueue_time": "string",
            "fips_mode": false,
            "history": [
                {
                    "duration": 0,
                    "end_time": "string",
                    "ops": "string",
                    "patch_version": "string",
                    "se_upgrade_events": [
                        {
                            "from_se_ref": "string",
                            "num_se": 0,
                            "num_se_group": 0,
                            "num_vs": 0,
                            "reason": [
                                "string"
                            ],
                            "se_group_ha_mode": "string",
                            "se_group_ref": "string",
                            "se_ref": "string",
                            "sub_tasks": [
                                "string"
                            ],
                            "task": "string",
                            "to_se_ref": "string",
                            "traffic_status": "string",
                            "vs_ref": "string"
                        }
                    ],
                    "seg_status": {
                        "controller_version": "string",
                        "disrupted_vs_ref": [
                            "string"
                        ],
                        "duration": "string",
                        "end_time": "string",
                        "enqueue_time": "string",
                        "ha_mode": "string",
                        "in_progress": false,
                        "notes": [
                            "string"
                        ],
                        "num_se": 0,
                        "num_se_with_no_vs": 0,
                        "num_se_with_vs_not_scaledout": 0,
                        "num_se_with_vs_scaledout": 0,
                        "num_vs": 0,
                        "num_vs_disrupted": 0,
                        "progress": 0,
                        "reason": [
                            "string"
                        ],
                        "request_time": "string",
                        "se_already_upgraded_at_start": [
                            "string"
                        ],
                        "se_disconnected_at_start": [
                            "string"
                        ],
                        "se_group_name": "string",
                        "se_group_uuid": "string",
                        "se_ip_missing_at_start": [
                            "string"
                        ],
                        "se_poweredoff_at_start": [
                            "string"
                        ],
                        "se_reboot_in_progress_ref": "string",
                        "se_upgrade_completed": [
                            "string"
                        ],
                        "se_upgrade_errors": [
                            {
                                "from_se_ref": "string",
                                "num_se": 0,
                                "num_se_group": 0,
                                "num_vs": 0,
                                "reason": [
                                    "string"
                                ],
                                "se_group_ha_mode": "string",
                                "se_group_ref": "string",
                                "se_ref": "string",
                                "sub_tasks": [
                                    "string"
                                ],
                                "task": "string",
                                "to_se_ref": "string",
                                "traffic_status": "string",
                                "vs_ref": "string"
                            }
                        ],
                        "se_upgrade_failed": [
                            "string"
                        ],
                        "se_upgrade_in_progress": [
                            "string"
                        ],
                        "se_upgrade_not_started": [
                            "string"
                        ],
                        "se_upgrade_skip_suspended": [
                            "string"
                        ],
                        "se_upgrade_suspended": [
                            "string"
                        ],
                        "se_with_no_vs": [
                            "string"
                        ],
                        "se_with_vs_not_scaledout": [
                            "string"
                        ],
                        "se_with_vs_scaledout": [
                            "string"
                        ],
                        "start_time": "string",
                        "state": "string",
                        "tenant_ref": "string",
                        "thread": "string",
                        "traffic_status": "string",
                        "vs_errors": [
                            {
                                "event_timestamp": {
                                    "secs": 0,
                                    "usecs": 0
                                },
                                "reason": [
                                    "string"
                                ],
                                "se_group_ha_mode": "string",
                                "se_group_ref": "string",
                                "se_ref": "string",
                                "tenant_ref": "string",
                                "traffic_status": "string",
                                "vip_id": "string",
                                "vs_ref": "string"
                            }
                        ],
                        "vs_migrate_in_progress_ref": [
                            "string"
                        ],
                        "vs_scalein_in_progress_ref": [
                            "string"
                        ],
                        "vs_scaleout_in_progress_ref": [
                            "string"
                        ],
                        "worker": "string"
                    },
                    "start_time": "string",
                    "state": {
                        "last_changed_time": {
                            "secs": 0,
                            "usecs": 0
                        },
                        "reason": "string",
                        "rebooted": false,
                        "state": "string"
                    },
                    "statediff_ref": "string",
                    "upgrade_events": [
                        {
                            "nodes_events": [
                                {
                                    "duration": 0,
                                    "end_time": "string",
                                    "ip": {
                                        "addr": "string",
                                        "type": "string"
                                    },
                                    "message": "string",
                                    "start_time": "string",
                                    "status": false,
                                    "sub_tasks": [
                                        "string"
                                    ]
                                }
                            ],
                            "sub_events": [
                                {
                                    "duration": 0,
                                    "end_time": "string",
                                    "ip": {
                                        "addr": "string",
                                        "type": "string"
                                    },
                                    "message": "string",
                                    "start_time": "string",
                                    "status": false,
                                    "sub_tasks": [
                                        "string"
                                    ]
                                }
                            ],
                            "task": "string",
                            "task_name": "string"
                        }
                    ],
                    "version": "string"
                }
            ],
            "image_path": "string",
            "image_ref": "string",
            "name": "string",
            "node_type": "string",
            "obj_cloud_ref": "string",
            "params": {
                "controller": {
                    "task_base_timeout": 0
                },
                "image_ref": "string",
                "patch_ref": "string",
                "se_group_options": {
                    "action_on_error": "string",
                    "disruptive": false
                },
                "se_group_resume_options": {
                    "action_on_error": "string",
                    "disruptive": false,
                    "skip_suspended": false
                },
                "service_engine": {
                    "concurrent_segroup_upgrades": 0,
                    "image_data_transfer_size": 0,
                    "large_se_connect_timeout": 0,
                    "se_connect_timeout": 0,
                    "simultaneous_image_downloads": 0,
                    "task_base_timeout": 0
                }
            },
            "patch_image_path": "string",
            "patch_image_ref": "string",
            "patch_list": [
                {
                    "patch_image_path": "string",
                    "patch_image_ref": "string",
                    "patch_version": "string"
                }
            ],
            "patch_reboot": false,
            "patch_version": "string",
            "prev_image_path": "string",
            "prev_patch_image_path": "string",
            "prev_remote_image_ref": "string",
            "previous_image_ref": "string",
            "previous_patch_image_ref": "string",
            "previous_patch_list": [
                {
                    "patch_image_path": "string",
                    "patch_image_ref": "string",
                    "patch_version": "string"
                }
            ],
            "previous_patch_version": "string",
            "previous_version": "string",
            "progress": 0,
            "reason": "string",
            "remote_image_ref": "string",
            "se_patch_image_path": "string",
            "se_patch_image_ref": "string",
            "se_upgrade_events": [
                {
                    "from_se_ref": "string",
                    "num_se": 0,
                    "num_se_group": 0,
                    "num_vs": 0,
                    "reason": [
                        "string"
                    ],
                    "se_group_ha_mode": "string",
                    "se_group_ref": "string",
                    "se_ref": "string",
                    "sub_tasks": [
                        "string"
                    ],
                    "task": "string",
                    "to_se_ref": "string",
                    "traffic_status": "string",
                    "vs_ref": "string"
                }
            ],
            "seg_params": {
                "controller": {
                    "task_base_timeout": 0
                },
                "image_ref": "string",
                "patch_ref": "string",
                "se_group_options": {
                    "action_on_error": "string",
                    "disruptive": false
                },
                "se_group_resume_options": {
                    "action_on_error": "string",
                    "disruptive": false,
                    "skip_suspended": false
                },
                "service_engine": {
                    "concurrent_segroup_upgrades": 0,
                    "image_data_transfer_size": 0,
                    "large_se_connect_timeout": 0,
                    "se_connect_timeout": 0,
                    "simultaneous_image_downloads": 0,
                    "task_base_timeout": 0
                }
            },
            "seg_status": {
                "controller_version": "string",
                "disrupted_vs_ref": [
                    "string"
                ],
                "duration": "string",
                "end_time": "string",
                "enqueue_time": "string",
                "ha_mode": "string",
                "in_progress": false,
                "notes": [
                    "string"
                ],
                "num_se": 0,
                "num_se_with_no_vs": 0,
                "num_se_with_vs_not_scaledout": 0,
                "num_se_with_vs_scaledout": 0,
                "num_vs": 0,
                "num_vs_disrupted": 0,
                "progress": 0,
                "reason": [
                    "string"
                ],
                "request_time": "string",
                "se_already_upgraded_at_start": [
                    "string"
                ],
                "se_disconnected_at_start": [
                    "string"
                ],
                "se_group_name": "string",
                "se_group_uuid": "string",
                "se_ip_missing_at_start": [
                    "string"
                ],
                "se_poweredoff_at_start": [
                    "string"
                ],
                "se_reboot_in_progress_ref": "string",
                "se_upgrade_completed": [
                    "string"
                ],
                "se_upgrade_errors": [
                    {
                        "from_se_ref": "string",
                        "num_se": 0,
                        "num_se_group": 0,
                        "num_vs": 0,
                        "reason": [
                            "string"
                        ],
                        "se_group_ha_mode": "string",
                        "se_group_ref": "string",
                        "se_ref": "string",
                        "sub_tasks": [
                            "string"
                        ],
                        "task": "string",
                        "to_se_ref": "string",
                        "traffic_status": "string",
                        "vs_ref": "string"
                    }
                ],
                "se_upgrade_failed": [
                    "string"
                ],
                "se_upgrade_in_progress": [
                    "string"
                ],
                "se_upgrade_not_started": [
                    "string"
                ],
                "se_upgrade_skip_suspended": [
                    "string"
                ],
                "se_upgrade_suspended": [
                    "string"
                ],
                "se_with_no_vs": [
                    "string"
                ],
                "se_with_vs_not_scaledout": [
                    "string"
                ],
                "se_with_vs_scaledout": [
                    "string"
                ],
                "start_time": "string",
                "state": "string",
                "tenant_ref": "string",
                "thread": "string",
                "traffic_status": "string",
                "vs_errors": [
                    {
                        "event_timestamp": {
                            "secs": 0,
                            "usecs": 0
                        },
                        "reason": [
                            "string"
                        ],
                        "se_group_ha_mode": "string",
                        "se_group_ref": "string",
                        "se_ref": "string",
                        "tenant_ref": "string",
                        "traffic_status": "string",
                        "vip_id": "string",
                        "vs_ref": "string"
                    }
                ],
                "vs_migrate_in_progress_ref": [
                    "string"
                ],
                "vs_scalein_in_progress_ref": [
                    "string"
                ],
                "vs_scaleout_in_progress_ref": [
                    "string"
                ],
                "worker": "string"
            },
            "start_time": "string",
            "state": {
                "last_changed_time": {
                    "secs": 0,
                    "usecs": 0
                },
                "reason": "string",
                "rebooted": false,
                "state": "string"
            },
            "statediff_ref": "string",
            "system": false,
            "system_report_refs": [
                "string"
            ],
            "tasks_completed": 0,
            "tenant_ref": "string",
            "total_tasks": 0,
            "upgrade_events": [
                {
                    "nodes_events": [
                        {
                            "duration": 0,
                            "end_time": "string",
                            "ip": {
                                "addr": "string",
                                "type": "string"
                            },
                            "message": "string",
                            "start_time": "string",
                            "status": false,
                            "sub_tasks": [
                                "string"
                            ]
                        }
                    ],
                    "sub_events": [
                        {
                            "duration": 0,
                            "end_time": "string",
                            "ip": {
                                "addr": "string",
                                "type": "string"
                            },
                            "message": "string",
                            "start_time": "string",
                            "status": false,
                            "sub_tasks": [
                                "string"
                            ]
                        }
                    ],
                    "task": "string",
                    "task_name": "string"
                }
            ],
            "upgrade_ops": "string",
            "upgrade_readiness": {
                "checks": [
                    {
                        "check_code": "string",
                        "description": "string",
                        "details": [
                            "string"
                        ],
                        "duration": 0,
                        "end_time": "string",
                        "error_details": [
                            "string"
                        ],
                        "start_time": "string",
                        "state": "string"
                    }
                ],
                "checks_completed": 0,
                "duration": 0,
                "end_time": "string",
                "image_ref": "string",
                "patch_image_ref": "string",
                "progress": 0,
                "start_time": "string",
                "state": {
                    "last_changed_time": {
                        "secs": 0,
                        "usecs": 0
                    },
                    "reason": "string",
                    "rebooted": false,
                    "state": "string"
                },
                "total_checks": 0,
                "upgrade_ops": "string"
            },
            "url": "string",
            "uuid": "string",
            "version": "string"
        }
    ],
    "next": "string"
}
integer As int32 As int32
count
Required

count

array of object
results
Required

results

string
next
Optional

next


401

log in failed

Operation doesn't return any data structure

Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/api/upgradestatusinfo