[{"label":"Latest (4.5.0)","version":"latest"},{"version":"4.4.0"},{"version":"4.3.1"},{"link":"https://developer.vmware.com/apis/1126/vmware-cloud-foundation","version":"4.3"},{"link":"https://developer.vmware.com/apis/1077/vmware-cloud-foundation","version":"4.2"},{"link":"https://developer.vmware.com/apis/1032/vmware-cloud-foundation","version":"4.1"},{"link":"https://developer.vmware.com/apis/1002/vmware-cloud-foundation","version":"4.0.1"},{"link":"https://developer.vmware.com/apis/921/vmware-cloud-foundation","version":"4.0"},{"link":"https://developer.vmware.com/apis/925/vmware-cloud-foundation","version":"3.10"},{"link":"https://developer.vmware.com/apis/891/vmware-cloud-foundation","version":"3.9.1"},{"link":"https://developer.vmware.com/apis/723/vmware-cloud-foundation","version":"3.9.0"},{"link":"https://developer.vmware.com/apis/711/vmware-cloud-foundation","version":"3.8.1"},{"link":"https://developer.vmware.com/apis/685/vmware-cloud-foundation","version":"3.8"}]

vcf

Create SDDC

Description

Create SDDC

Request

URL

post

https://sfo-vcf01.rainpole.io/v1/sddcs

Copy

Request Body

SddcSpec of type(s) application/json Required

SDDC specification

Show optional properties

{
    "sddcId": "sfo01-m01",
    "taskName": "workflowconfig/workflowspec-ems.json"
}

{
    "ceipEnabled": "true",
    "dvSwitchVersion": "One among:6.0.0, 6.5.0, 7.0.0",
    "excludedComponents": "One among:Foundation, VsphereHostProfiles, LogInsight, NSX, VrealizeNetwork, VSAN, VSANCleanup, VROPS, VRA, DRDeployment, DRConfiguration, ConfigurationBackup, VRB, VRSLCM, Inventory, UMDS, EsxThumbprintValidation, AVN, CEIP, Backup, EBGP",
    "fipsEnabled": "true",
    "sddcId": "sfo01-m01",
    "shouldCleanupVsan": "false",
    "taskName": "workflowconfig/workflowspec-ems.json"
}

array of SddcHostSpec

hostSpecs Required

List of Host Specs

SddcVcenterSpec

vcenterSpec Required

vCenter Spec

SddcClusterSpec

clusterSpec Required

Cluster Spec

DnsSpec

dnsSpec Required

DNS Spec

string

taskName Required

Name of the task to execute

array of DvsSpec

dvsSpecs Required

List of Dvs Specs

string

sddcId Required

Client string that identifies an SDDC by name or instance name. Used for management domain name. Can contain only letters, numbers and the following symbols: ‘-’.

array of string

ntpServers Required

List of NTP servers

array of SddcNetworkSpec

networkSpecs Required

List of Network Specs

boolean

ceipEnabled Optional

Enable VCF Customer Experience Improvement Program

string

managementPoolName Optional

A String identifying the network pool associated with the management domain

boolean

fipsEnabled Optional

Enable Federal Information Processing Standards

SddcNsxtSpec

nsxtSpec Optional

NSX-T Spec

array of string

excludedComponents Optional

Components to be excluded

array of PscSpec

pscSpecs Optional

PSC VM spec

RemoteSiteSpec

remoteSiteSpec Optional

Remote site spec

string

esxLicense Optional

License for the ESXi hosts

SddcManagerSpec

sddcManagerSpec Optional

SDDC Manager Virtual Machine spec

SecuritySpec

securitySpec Optional

Security spec

boolean

shouldCleanupVsan Optional

Flag indicating whether cleanup vSAN should be ran

boolean

skipEsxThumbprintValidation Optional

Skip ESXi thumbprint validation

boolean

skipGatewayPingValidation Optional

Skip VSAN / VMOTION networks gateway connectivity validation

string

dvSwitchVersion Optional

The version of the distributed virtual switches to be used

string

certificatesPassphrase Optional

Passphrase for the vCenter / NSX certificates

VsanSpec

vsanSpec Optional

VSAN Spec

VxManagerSpec

vxManagerSpec Optional

VxManager Spec

Response

200 OK Response Body>

Response Body

200 OK

Returns SddcTask of type(s) application/json

{
    "status": "One among: IN_PROGRESS, COMPLETED_WITH_SUCCESS, ROLLBACK_SUCCESS, COMPLETED_WITH_FAILURE"
}

string

creationTimestamp Optional

SDDC Task creation timestamp

string

id Optional

SDDC ID

MessagePack

localizableNamePack Optional

Localizable SDDC Task name

string

name Optional

Task name

array of SddcSubTask

sddcSubTasks Optional

All SDDC Sub-Tasks

string

status Optional

SDDC Task status

202 Accepted Response Body>

Response Body

202 Accepted

Returns SddcTask of type(s) application/json

{
    "status": "One among: IN_PROGRESS, COMPLETED_WITH_SUCCESS, ROLLBACK_SUCCESS, COMPLETED_WITH_FAILURE"
}

string

creationTimestamp Optional

SDDC Task creation timestamp

string

id Optional

SDDC ID

MessagePack

localizableNamePack Optional

Localizable SDDC Task name

string

name Optional

Task name

array of SddcSubTask

sddcSubTasks Optional

All SDDC Sub-Tasks

string

status Optional

SDDC Task status

Errors

Error

400

SDDC already exists, Bad Request

Error

500

Internal Server Error

Code Samples

cURL Command

curl -X POST -H "Content-Type: application/json" -d '{"ceipEnabled":"true","dvSwitchVersion":"One among:6.0.0, 6.5.0, 7.0.0","excludedComponents":"One among:Foundation, VsphereHostProfiles, LogInsight, NSX, VrealizeNetwork, VSAN, VSANCleanup, VROPS, VRA, DRDeployment, DRConfiguration, ConfigurationBackup, VRB, VRSLCM, Inventory, UMDS, EsxThumbprintValidation, AVN, CEIP, Backup, EBGP","fipsEnabled":"true","sddcId":"sfo01-m01","shouldCleanupVsan":"false","taskName":"workflowconfig/workflowspec-ems.json"}' https://sfo-vcf01.rainpole.io/v1/sddcs

vcf

SDDC Operations

post

Convert To JSON Spec

post

Create SDDC

get

Get All SDDC Validations

get

Get Bringup Detail Report

get

Get Bringup Info

get

Get Bringup Validation Report

get

Get SDDC Manager Info

get

Get SDDC Validation

get

Retrieve All SDDCs

get

Retrieve SDDC

patch

Retry SDDC

patch

Retry SDDC Validation

post

Validate SDDC Spec

Create SDDC

Request

URL

Request Body

Response

Response Body

200 OK

Response Body

202 Accepted

Errors

Code Samples

cURL Command

On This Page

SDDC Operations

Was this page helpful?