[{"label":"Latest (v1.1)","version":"latest"}]
vmc

Create Clusters

Description

Creates a new cluster in customers sddcs with passed clusterConfig.

Request

Request

URL

URL


post
https://vmc.vmware.com/vmc/api/orgs/{org}/sddcs/{sddc}/clusters
Copy

Path Parameters

Path Parameters

string
org Required

Organization identifier


string
sddc Required

Sddc identifier


Request Body

Request Body

ClusterConfig of type(s) application/json Required

clusterConfig

{
	"num_hosts": 0
}
integer as int32
num_hosts Required

integer as int32
host_cpu_cores_count Optional

Customize CPU cores on hosts in a cluster. Specify number of cores to be enabled on hosts in a cluster.


host_instance_type Optional

Possible values are: i3.metalr5.metali3en.metal


msft_license_config Optional

The desired Microsoft license status to apply to this cluster.


integer as int64
storage_capacity Optional

For EBS-backed instances only, the requested storage capacity in GiB.

Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

202 Accepted

Returns Task of type(s) application/json
This response body class contains all of the following: AbstractEntity, InlineTask1
Errors

Errors

ErrorResponse
400

The sddc is not in a state that’s valid for updates


401

Unauthorized


ErrorResponse
403

Access not allowed to the operation for the current user


ErrorResponse
404

Cannot find the cluster with the given identifier

Code Samples

Code Samples

cURL Command

curl -X POST -H "Content-Type: application/json" -d '{"host_cpu_cores_count":0,"host_instance_type":"i3.metal","msft_license_config":{"academic_license":false,"mssql_licensing":"DISABLED","windows_licensing":"DISABLED"},"num_hosts":0,"storage_capacity":0}' https://vmc.vmware.com/vmc/api/orgs/{org}/sddcs/{sddc}/clusters
Vendor Extensions

Vendor Extensions

This operation contains the following vendor extensions defined in the spec:
x-vmc-ui-servicename: clusters
x-vmw-vapi-methodname: create


Feedback

Was this page helpful?