Update Cluster
Update a Cluster by adding or removing Hosts, Stretching a standard vSAN cluster, Unstretching a stretched cluster or by marking for deletion
Cluster ID
Cluster Update Data
{
"clusterCompactionSpec": {
"force": false,
"forceByPassingSafeMinSize": false,
"hosts": [
{
"azName": "string",
"fqdn": "string",
"id": "string",
"ipAddress": "string",
"vmNics": [
{
"isActive": false,
"isAutoNegotiateSupported": false,
"isInUse": false,
"linkSpeedMB": 0,
"name": "string"
}
]
}
]
},
"clusterExpansionSpec": {
"forceHostAdditionInPresenceofDeadHosts": false,
"hostSpecs": [
{
"azName": "string",
"hostName": "string",
"hostNetworkSpec": {
"vmNics": [
{
"id": "string",
"moveToNvds": false,
"uplink": "string",
"vdsName": "string"
}
]
},
"id": "string",
"ipAddress": "string",
"licenseKey": "string",
"password": "string",
"serialNumber": "string",
"sshThumbprint": "string",
"username": "string"
}
],
"interRackExpansion": false,
"skipThumbprintValidation": false,
"vsanNetworkSpecs": [
{
"vsanCidr": "string",
"vsanGatewayIP": "string"
}
],
"witnessSpec": {
"fqdn": "string",
"vsanCidr": "string",
"vsanIp": "string"
},
"witnessTrafficSharedWithVsanTraffic": false
},
"clusterStretchSpec": {
"hostSpecs": [
{
"azName": "string",
"hostName": "string",
"hostNetworkSpec": {
"vmNics": [
{
"id": "string",
"moveToNvds": false,
"uplink": "string",
"vdsName": "string"
}
]
},
"id": "string",
"ipAddress": "string",
"licenseKey": "string",
"password": "string",
"serialNumber": "string",
"sshThumbprint": "string",
"username": "string"
}
],
"isEdgeClusterConfiguredForMultiAZ": false,
"secondaryAzOverlayVlanId": 0,
"vsanNetworkSpecs": [
{
"vsanCidr": "string",
"vsanGatewayIP": "string"
}
],
"witnessSpec": {
"fqdn": "string",
"vsanCidr": "string",
"vsanIp": "string"
},
"witnessTrafficSharedWithVsanTraffic": false
},
"markForDeletion": false,
"name": "string",
"prepareForStretch": false
}
This specification contains the parameters required to remove one or more vSphere hosts from existing cluster in a workload domain
This specification contains the parameters required to add one or more vSphere hosts to an existing cluster in a workload domain
This spec contains the parameters required to convert a Standard vSAN cluster to a Stretched cluster
This spec contains the parameters required to convert a Stretched cluster to a Standard vSAN cluster
Prepare the cluster for deletion
Cluster Name
Prepare the cluster for stretch
Ok
{
"completionTimestamp": "string",
"creationTimestamp": "string",
"errors": [
{
"arguments": [
"string"
],
"causes": [
{
"message": "string",
"type": "string"
}
],
"context": {
"context": "string"
},
"errorCode": "string",
"errorType": "string",
"message": "string",
"nestedErrors": [
"Error Object"
],
"referenceToken": "string",
"remediationMessage": "string"
}
],
"id": "string",
"isCancellable": false,
"localizableDescriptionPack": {
"arguments": [
"string"
],
"component": "string",
"message": "string",
"messageKey": "string"
},
"name": "string",
"resolutionStatus": "Can have only one of the two values: RESOLVED or UNRESOLVED",
"resources": [
{
"fqdn": "sfo-vc01.rainpole.io",
"name": "string",
"resourceId": "BE8A5E04-92A0-43F6-A166-AA041F4327CC",
"sans": [
"string"
],
"type": "One among: SDDC_MANAGER, PSC, VCENTER, NSX_MANAGER, NSXT_MANAGER, VRA, VRLI, VROPS, VRSLCM, VXRAIL_MANAGER"
}
],
"status": "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
"subTasks": [
{
"completionTimestamp": "string",
"creationTimestamp": "string",
"description": "string",
"errors": [
{
"arguments": [
"string"
],
"causes": [
{
"message": "string",
"type": "string"
}
],
"context": {
"context": "string"
},
"errorCode": "string",
"errorType": "string",
"message": "string",
"nestedErrors": [
"Error Object"
],
"referenceToken": "string",
"remediationMessage": "string"
}
],
"name": "string",
"resources": [
{
"fqdn": "sfo-vc01.rainpole.io",
"name": "string",
"resourceId": "BE8A5E04-92A0-43F6-A166-AA041F4327CC",
"sans": [
"string"
],
"type": "One among: SDDC_MANAGER, PSC, VCENTER, NSX_MANAGER, NSXT_MANAGER, VRA, VRLI, VROPS, VRSLCM, VXRAIL_MANAGER"
}
],
"stages": [
{
"completionTimestamp": "string",
"creationTimestamp": "string",
"description": "string",
"errors": [
{
"arguments": [
"string"
],
"causes": [
{
"message": "string",
"type": "string"
}
],
"context": {
"context": "string"
},
"errorCode": "string",
"errorType": "string",
"message": "string",
"nestedErrors": [
"Error Object"
],
"referenceToken": "string",
"remediationMessage": "string"
}
],
"name": "string",
"status": "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
"type": "string"
}
],
"status": "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, NOT_APPLICABLE",
"subTasks": [
"SubTask Object"
],
"type": "string"
}
],
"type": "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Task completion timestamp
Task creation timestamp
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
Task status
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
{
"completionTimestamp": "string",
"creationTimestamp": "string",
"errors": [
{
"arguments": [
"string"
],
"causes": [
{
"message": "string",
"type": "string"
}
],
"context": {
"context": "string"
},
"errorCode": "string",
"errorType": "string",
"message": "string",
"nestedErrors": [
"Error Object"
],
"referenceToken": "string",
"remediationMessage": "string"
}
],
"id": "string",
"isCancellable": false,
"localizableDescriptionPack": {
"arguments": [
"string"
],
"component": "string",
"message": "string",
"messageKey": "string"
},
"name": "string",
"resolutionStatus": "Can have only one of the two values: RESOLVED or UNRESOLVED",
"resources": [
{
"fqdn": "sfo-vc01.rainpole.io",
"name": "string",
"resourceId": "BE8A5E04-92A0-43F6-A166-AA041F4327CC",
"sans": [
"string"
],
"type": "One among: SDDC_MANAGER, PSC, VCENTER, NSX_MANAGER, NSXT_MANAGER, VRA, VRLI, VROPS, VRSLCM, VXRAIL_MANAGER"
}
],
"status": "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
"subTasks": [
{
"completionTimestamp": "string",
"creationTimestamp": "string",
"description": "string",
"errors": [
{
"arguments": [
"string"
],
"causes": [
{
"message": "string",
"type": "string"
}
],
"context": {
"context": "string"
},
"errorCode": "string",
"errorType": "string",
"message": "string",
"nestedErrors": [
"Error Object"
],
"referenceToken": "string",
"remediationMessage": "string"
}
],
"name": "string",
"resources": [
{
"fqdn": "sfo-vc01.rainpole.io",
"name": "string",
"resourceId": "BE8A5E04-92A0-43F6-A166-AA041F4327CC",
"sans": [
"string"
],
"type": "One among: SDDC_MANAGER, PSC, VCENTER, NSX_MANAGER, NSXT_MANAGER, VRA, VRLI, VROPS, VRSLCM, VXRAIL_MANAGER"
}
],
"stages": [
{
"completionTimestamp": "string",
"creationTimestamp": "string",
"description": "string",
"errors": [
{
"arguments": [
"string"
],
"causes": [
{
"message": "string",
"type": "string"
}
],
"context": {
"context": "string"
},
"errorCode": "string",
"errorType": "string",
"message": "string",
"nestedErrors": [
"Error Object"
],
"referenceToken": "string",
"remediationMessage": "string"
}
],
"name": "string",
"status": "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
"type": "string"
}
],
"status": "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, NOT_APPLICABLE",
"subTasks": [
"SubTask Object"
],
"type": "string"
}
],
"type": "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Task completion timestamp
Task creation timestamp
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
Task status
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
{
"arguments": [
"string"
],
"causes": [
{
"message": "string",
"type": "string"
}
],
"context": {
"context": "string"
},
"errorCode": "string",
"errorType": "string",
"message": "string",
"nestedErrors": [
"Error Object"
],
"referenceToken": "string",
"remediationMessage": "string"
}
The arguments used to localize the message, Can be used by scripts to automate the error processing.
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
Not Found
{
"arguments": [
"string"
],
"causes": [
{
"message": "string",
"type": "string"
}
],
"context": {
"context": "string"
},
"errorCode": "string",
"errorType": "string",
"message": "string",
"nestedErrors": [
"Error Object"
],
"referenceToken": "string",
"remediationMessage": "string"
}
The arguments used to localize the message, Can be used by scripts to automate the error processing.
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
InternalServerError
{
"arguments": [
"string"
],
"causes": [
{
"message": "string",
"type": "string"
}
],
"context": {
"context": "string"
},
"errorCode": "string",
"errorType": "string",
"message": "string",
"nestedErrors": [
"Error Object"
],
"referenceToken": "string",
"remediationMessage": "string"
}
The arguments used to localize the message, Can be used by scripts to automate the error processing.
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