Upgrade Multiple Software Clusters
Released in v7.0.0.0Upgrade a set of clusters to its corresponding specific version.
Request
URLURL
https://{api_host}/api/vcenter/namespace-management/software/clusters?action=upgradeMultiple
Header Parameters
Header Parameters
string
vmware-api-session-id
Required
Required session ID, obtained by first calling Create Session API
Example: b00db39f948d13ea1e59b4d6fce56389
Request Body
Request Body
map of NamespaceManagementSoftwareClustersUpgradeSpec of type application/json (required){
"desired_version": "string"
}
string
desired_version
Required
Version number the cluster is going to be upgraded to.
boolean
ignore_precheck_warnings
Optional
If true, the upgrade workflow will ignore any pre-check warnings and proceed with the upgrade. If unset, the upgrade workflow will not ignore pre-check warnings and fail the upgrade. It is equivalent to setting the value to false. The workflow adopts a conservative approach of failing the upgrade if unset to solely let the user decide whether to force the upgrade despite the warnings.
Response
Response
Response BodyResponse Body
200 OK returns
map of
NamespaceManagementSoftwareClustersResult
of type application/json
Pre-check result when invoking upgrade for each cluster. The key in the result map will be an identifier for the resource type: ClusterComputeResource.
{
"res": "enum"
}
res
Required
The result of batch upgrade method.
Possible values are:
object
exception
Optional
Exception when cluster pre-check failed during upgrade invocation. This field is optional and it is only relevant when the value of Clusters.Result.res is REJECTED.
cURL Command
curl -X POST -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" -H "Content-Type: application/json" -d '{"desired_version":"string","ignore_precheck_warnings":false}' https://{api_host}/api/vcenter/namespace-management/software/clusters?action=upgradeMultiple
Errors
404
com.vmware.vapi.std.errors.error : if the system reports an error while responding to the request.
401
com.vmware.vapi.std.errors.unauthenticated : if the user can not be authenticated. | com.vmware.vapi.std.errors.unauthorized : if the user does not have Namespaces.Manage privilege on all specified clusters.
