HTTP Requests for Upgrade Stage 2

You can use HTTP requests or the API to upgrade your vCenter Server Appliance and Platform Services Controller appliance.

HTTP Requests

HTTP requests for Upgrading

■

Validate the upgrade spec

POST https://<IP_address_target_appliance>:5480/rest/vcenter/deployment/upgrade?action=check

■

Run the upgrading

POST https://<IP_address_target_appliance>:5480/rest/vcenter/deployment/upgrade?action=start

■

Get the upgrade spec used for upgrading

GET https:// https://<IP_address_upgraded_appliance>:5480/rest/vcenter/deployment/upgrade

HTTP requests for getting and answering a question

■

Get the raised question

GET https://<IP_address_upgraded_or_target_appliance>:5480/rest/vcenter/deployment/question

■

Answer to the question

POST https://<IP_address_upgraded_or_target_appliance>:5480/rest/vcenter/deployment/question?action=answer

HTTP requests for diagnostic and deferring the transfer of historical data

■	Get the state of the appliance GET https://<`IP_address_upgraded_or_target_appliance`>:5480/rest/vcenter/deployment
■	Check the deployment type GET https://<`IP_address_upgraded_or_target_appliance`>:5480/rest/vcenter/system-config/deployment-type
■	Check the Platform Services Controller registration GET: https://<`IP_address_upgraded_appliance`>:5480/rest/vcenter/system-config/psc-registration
■	Get the list of services GET: https://<`IP_address_upgraded_appliance`>:5480/rest/vcenter/services
■	Pausing the transfer of historical data of the vCenter Server POST https://<`IP_address_upgraded_appliance`>:5480/rest/vcenter/deployment/history?action=pause

For information about the content of the HTTP request body and the syntax of spec, psc, source_appliance, source_location, vcsa_embedded, and history, see the API reference documentation.

Note

When you send the requests, you must authenticate with vCenter Server Appliance root credentials.

HTTP Status Codes and Errors

HTTP Status Code

Description

Operations That Return the Status Code

200

The operation is successful.

All operations. You can check the returned data in the results data structure.

400

You cannot perform the operation because the appliance is in the current state. For information about the states of the appliance, see the Upgrading the vCenter Server Appliance and Platform Services Controller Appliance topic.

■	Validate the upgrade spec
■	Run the upgrade
■	Get the upgrade spec
■	Get the raised question
■	Answer to the question
■	Get the state of the appliance

401

You use invalid user name or password, or authentication is failed.

■	Validate the upgrade spec
■	Run the upgrade
■	Get the upgrade spec
■	Get the raised question
■	Answer to the question
■	Get the state of the appliance

404

The state of the appliance cannot be determined

Get the state of the appliance.

500

There is a vapi std error. For information about the types of vapi std errors, see the vapi.std.errors API in the API Reference documentation.

Get the raised question.

If errors appear during the upgrade process, you can check the results data structure, the API log file, and download the appliance support bundle from https://FQDN_IP_address_of_your_appliance:443/appliance/support-bundle.