[{"label":"Latest (5.0.0)","version":"latest"},{"version":"4.5.1"},{"version":"4.5.0"},{"version":"4.4.0"},{"version":"4.3.1"},{"link":"https://developer.vmware.com/apis/1127/vmware-cloud-foundation","version":"4.3"},{"link":"https://developer.vmware.com/apis/1078/vmware-cloud-foundation","version":"4.2"},{"link":"https://developer.vmware.com/apis/1033/vmware-cloud-foundation","version":"4.1"},{"link":"https://developer.vmware.com/apis/1003/vmware-cloud-foundation","version":"4.0.1"},{"link":"https://developer.vmware.com/apis/939/vmware-cloud-foundation","version":"4.0"}]

vcf-for-vxrail

Update Cluster

Description

Update a Cluster by adding or removing Hosts, Stretching a standard vSAN cluster, Unstretching a stretched cluster or by marking for deletion

Request

URL

patch

https://sfo-vcf01.rainpole.io/v1/clusters/{id}

Copy

Path Parameters

string

id Required

Cluster ID

Request Body

ClusterUpdateSpec of type(s) application/json Required

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
	},
	"clusterUnstretchSpec": {},
	"markForDeletion": false,
	"name": "string",
	"prepareForStretch": false
}

ClusterCompactionSpec

clusterCompactionSpec Optional

Parameters required to perform cluster compaction, optional otherwise

ClusterExpansionSpec

clusterExpansionSpec Optional

Parameters required to perform cluster expansion, optional otherwise

ClusterStretchSpec

clusterStretchSpec Optional

Parameters required to perform Stretch operation on cluster, optional otherwise

ClusterUnstretchSpec

clusterUnstretchSpec Optional

Parameters required to perform Unstretch operation on cluster, optional otherwise

boolean

markForDeletion Optional

Prepare the cluster for deletion

string

name Optional

Cluster Name

boolean

prepareForStretch Optional

Prepare the cluster for stretch

Response

200 OK Response Body>

Response Body

200 OK

Returns Task of type(s) application/json

{
    "resolutionStatus": "Can have only one of the two values: RESOLVED or UNRESOLVED",
    "status": "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED, COMPLETED_WITH_WARNING, SKIPPED",
    "type": "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}

string

completionTimestamp Optional

Task completion timestamp

string

creationTimestamp Optional

Task creation timestamp

array of Error

errors Optional

List of errors in case of a failure

string

id Optional

Task ID

boolean

isCancellable Optional

Represents task can be cancellable or not.

MessagePack

localizableDescriptionPack Optional

Localizable Task description

string

name Optional

Task name

string

resolutionStatus Optional

Resolution state

array of Resource

resources Optional

List of resources associated with task

string

status Optional

Task status

array of SubTask

subTasks Optional

List of sub-tasks of the task

string

type Optional

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 _

202 Accepted Response Body>

Response Body

202 Accepted

Returns Task of type(s) application/json

{
    "resolutionStatus": "Can have only one of the two values: RESOLVED or UNRESOLVED",
    "status": "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED, COMPLETED_WITH_WARNING, SKIPPED",
    "type": "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}

string

completionTimestamp Optional

Task completion timestamp

string

creationTimestamp Optional

Task creation timestamp

array of Error

errors Optional

List of errors in case of a failure

string

id Optional

Task ID

boolean

isCancellable Optional

Represents task can be cancellable or not.

MessagePack

localizableDescriptionPack Optional

Localizable Task description

string

name Optional

Task name

string

resolutionStatus Optional

Resolution state

array of Resource

resources Optional

List of resources associated with task

string

status Optional

Task status

array of SubTask

subTasks Optional

List of sub-tasks of the task

string

type Optional

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 _

Errors

Error

400

Bad Request

Error

404

Not Found

Error

500

InternalServerError

Code Samples

cURL Command

curl -X PATCH -H "Content-Type: application/json" -d '{"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},"clusterUnstretchSpec":{},"markForDeletion":false,"name":"string","prepareForStretch":false}' https://sfo-vcf01.rainpole.io/v1/clusters/{id}

vcf-for-vxrail

Clusters Operations

post

Add Datastore To Cluster

put

Assign Tags To Existing Cluster

get

Assignable Tags To Cluster

post

Create Cluster

delete

Delete Cluster

get

Get Cluster

get

Get Cluster Create Validation

get

Get Cluster Datastores Introduced

get

Get Cluster Tag Manager URL

get

Get Cluster Update Validation

get

Get Clusters

get

Get Datastore Criterion

get

Get Datastore Query Response

get

Get Datastores Criteria

get

Get Host Criteria

get

Get Host Criterion

get

Get Host Query Response

get

Get Tags Assigned To Cluster

get

Get Tags Assigned To Clusters

get

Get VDses

post

Post Datastore Query

post

Post Host Query

delete

Remove Datastore From Cluster

delete

Remove Tags From Existing Cluster

patch

Update Cluster

post

Validate Cluster Operations

post

Validate Clusters Operations

post

Validate vSAN Remote Datastore Spec

Update Cluster

Request

URL

Path Parameters

Request Body

Response

Response Body

200 OK

Response Body

202 Accepted

Errors

Code Samples

cURL Command

On This Page

Clusters Operations

Was this page helpful?