HTTP Requests for Upgrade Stage 2

You can use HTTP requests or the API to upgrade your vCenter Server instance.

HTTP Requests

HTTP requests for upgrading

  • Get the state of the vCenter Server instance 
    GET https://<IP_address_upgraded_or_target_instance>:5480/rest/vcenter/deployment
  • Validate the upgrade spec 
    POST https://<IP_address_target_instance>:5480/rest/vcenter/deployment/upgrade?action=check
  • Run the upgrading 
    POST https://<IP_address_target_instance>:5480/rest/vcenter/deployment/upgrade?action=start
  • Get the upgrade spec used for upgrading 
    GET https:// https://<IP_address_upgraded_instance>:5480/rest/vcenter/deployment/upgrade

HTTP requests for getting and answering a question

  • Get the raised question 
    GET https://<IP_address_upgraded_or_target_instance>:5480/rest/vcenter/deployment/question
  • Answer to the question 
    POST https://<IP_address_upgraded_or_target_instance>:5480/rest/vcenter/deployment/question?action=answer

For information about the content and syntax of the HTTP request body, see the API reference documentation.

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

HTTP Status Codes and Errors

Table 1. 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 vCenter Server instance is in the current state. For information about the states of the vCenter Serverinstance, see the Upgrading a vCenter Server Instance topic.
  • Get the state of the vCenter Server instance
  • Validate the upgrade spec
  • Run the upgrade
  • Get the upgrade spec
  • Get the raised question
  • Answer the question
401 You use invalid user name or password, or authentication is failed.
  • Get the state of the vCenter Server instance
  • Validate the upgrade spec
  • Run the upgrade
  • Get the upgrade spec
  • Get the raised question
  • Answer the question
404 The state of the vCenter Server instance cannot be determined Get the state of the vCenter Server instance.
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 vCenter Server support bundle from https://<server>:443/appliance/support-bundle.