Perform Upgrade
Schedule/Trigger Upgrade of a Resource. Ex: Resource can be DOMAIN, CLUSTER, UNMANAGED_HOST etc. Performing upgrades are supported on VMware Cloud Foundation 3.5 BOM resources and above.
Upgrade Specification
Show optional properties
{
"bundleId": "string",
"resourceType": "One among: DOMAIN, CLUSTER, UNASSIGNED_HOST",
"resourceUpgradeSpecs": [
{
"resourceId": "string"
}
]
}
{
"bundleId": "string",
"draftMode": false,
"nsxtUpgradeUserInputSpecs": [
{
"nsxtEdgeClusterUpgradeSpecs": [
{
"edgeClusterId": "string",
"edgeParallelUpgrade": false
}
],
"nsxtHostClusterUpgradeSpecs": [
{
"hostClusterId": "string",
"hostParallelUpgrade": false,
"liveUpgrade": false
}
],
"nsxtId": "string",
"nsxtUpgradeOptions": {
"isEdgeClustersUpgradeParallel": false,
"isEdgeOnlyUpgrade": false,
"isHostClustersUpgradeParallel": false
}
}
],
"parallelUpgrade": false,
"resourceType": "One among: DOMAIN, CLUSTER, UNASSIGNED_HOST",
"resourceUpgradeSpecs": [
{
"customISOSpec": {
"hostIds": [
"string"
],
"id": "string"
},
"enableQuickboot": false,
"evacuateOfflineVms": false,
"personalitySpec": {
"hardwareSupportSpecs": [
{
"name": "string",
"packageSpec": {
"name": "string",
"version": "string"
}
}
],
"personalityId": "string"
},
"resourceId": "string",
"scheduledTimestamp": "string",
"shutdownVms": false,
"toVersion": "string",
"upgradeNow": false
}
],
"vcenterUpgradeUserInputSpecs": [
{
"temporaryNetwork": {
"gateway": "string",
"ipAddress": "string",
"subnetMask": "string"
}
}
]
}
Bundle ID for Upgrade
Boolean to represent upgrade will be created in DRAFT mode. This allows to run prechecks before user confirm/commit the upgrade.
Resource Upgrade Specifications for NSX upgrade
Boolean to represent components will be upgraded in parallel on not
Resource Type for Upgrade
Resource Upgrade Specifications
User Input for vCenter upgrade
OK
"Task Object"
Task completion timestamp
Task creation timestamp
List of errors in case of a failure
Task ID
Represents task can be cancellable or not.
A message pack representing a localizable message and suitable for machine processing. Contains a message key unique in the scope of the specified component, as well as the arguments needed to generate the localized message.
Task name
Resolution state
List of resources associated with task
Task status
List of sub-tasks of the task
Operation that is represented by the Task in machine readable format. The value is controlled by the owners/producers of the Task. The convention is
Accepted
"Task Object"
Task completion timestamp
Task creation timestamp
List of errors in case of a failure
Task ID
Represents task can be cancellable or not.
A message pack representing a localizable message and suitable for machine processing. Contains a message key unique in the scope of the specified component, as well as the arguments needed to generate the localized message.
Task name
Resolution state
List of resources associated with task
Task status
List of sub-tasks of the task
Operation that is represented by the Task in machine readable format. The value is controlled by the owners/producers of the Task. The convention is
Bad Request
"Error Object"
The arguments used to localize the message, Can be used by scripts to automate the error processing.
The underlying cause exceptions.
The error context (e.g. the component where it occurred).
The minor error code
The error type
The localized error message
A reference token correlating the error with the relevant detailed error logs. Should be sent to the service provider when reporting issues.
The localized remediation error message
Operation not allowed
"Error Object"
The arguments used to localize the message, Can be used by scripts to automate the error processing.
The underlying cause exceptions.
The error context (e.g. the component where it occurred).
The minor error code
The error type
The localized error message
A reference token correlating the error with the relevant detailed error logs. Should be sent to the service provider when reporting issues.
The localized remediation error message
Failed Dependency
"Error Object"
The arguments used to localize the message, Can be used by scripts to automate the error processing.
The underlying cause exceptions.
The error context (e.g. the component where it occurred).
The minor error code
The error type
The localized error message
A reference token correlating the error with the relevant detailed error logs. Should be sent to the service provider when reporting issues.
The localized remediation error message
Internal Server Error
"Error Object"
The arguments used to localize the message, Can be used by scripts to automate the error processing.
The underlying cause exceptions.
The error context (e.g. the component where it occurred).
The minor error code
The error type
The localized error message
A reference token correlating the error with the relevant detailed error logs. Should be sent to the service provider when reporting issues.
The localized remediation error message
curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"bundleId:"string","resourceType:"string","resourceUpgradeSpecs:"array"}' https://{api_host}/v1/upgrades