SDDC
APIs for managing SDDC. The /v1/sddcs APIs are available only on the Cloud Builder appliance.
Note : The /v1/sddcs APIs are available only on the Cloud Builder appliance
Table of Contents
1. Create an SDDC
Create an SDDC workflow executes automatically the following:
-
Configures networking on each host.
-
Configures vSAN storage on the hosts.
-
Deploys and configures the management stack - NSX
-
Deploys and configures SDDC Manager which provides the ability to perform Day 2 operations
1.1. Prerequisites
The following data is required
-
ID of the SDDC instance
-
Detailed list of host
Tip : Refer to: SddcHostSpec.
- vCenter details
Tip : Refer to: SddcVcenterSpec.
- Cluster details
Tip : Refer to: SddcClusterSpec.
- Detailed list of Distributed Virtual Switches
Tip : Refer to: DvsSpec.
Note : In the dvsSpec, ‘dvsName’ can either refer to the name of an existing System DVS that should be used for overlay traffic, or the name of the new to-be-deployed overlay DVS.
- Detailed list of networks
Tip : Refer to: SddcNetworkSpec.
- DNS details
Tip : Refer to: DnsSpec.
-
List of NTP servers
-
Name of the task to execute
The following data is optional
- vSAN details
Tip : Refer to: VsanSpec.
- NSX-T details
Tip : Refer to: SddcNsxtSpec.
Note : In order to configure NSX-T Host Overlay Using a Static IP Pool, please provide ipAddressPoolSpec in nsxtSpec. Otherwise, DHCP will be chosen. Example specifications can seen below.
- SDDC Manager details
Tip : Refer to: SddcManagerSpec.
- List of PSC’s details
Tip : Refer to: PscSpec.
- VxManager details
Tip : Refer to: VxManagerSpec.
-
Name of network pool associated with the management domain
-
List of names of the components to be excluded
-
Version of the Distributed Virtual Switch
-
Boolean to identify whether Customer Experience Improvement Program should be enabled
-
Boolean to identify whether Federal Information Processing Standards should be enabled
-
Remote Site details
Tip : Refer to: VxManagerSpec.
-
Passphrase for the certificates to be used for vCenter and NSX
-
Boolean to identify if ESXi thumbprint validation is to be skipped
-
Security details
Tip : Refer to: SecuritySpec.
- Boolean to identify if vSAN should be cleaned up
Note : Should be true only if this is the very first run
1.2. Steps
- Validate the input specification.
cURL Request
$ curl 'https://sfo-cb01.rainpole.local/v1/sddcs/validations' -i -u 'admin:VMwareInfra@1' -X POST \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
"skipEsxThumbprintValidation" : true,
"managementPoolName" : "",
"sddcManagerSpec" : {
"hostname" : "sddcbsddc-1",
"ipAddress" : "172.18.93.28",
"netmask" : "255.255.255.0",
"licenseKey" : "xxxx-xxxxx-xxxxx-xxxxx",
"localUserPassword" : "xxxxxxxx",
"rootUserCredentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"secondUserCredentials" : {
"username" : "vcf",
"password" : "xxxxxxxx"
}
},
"sddcId" : "MGMT",
"esxLicense" : "xxxx-xxxxx-xxxxx-xxxxx",
"taskName" : "workflowconfig/workflowspec-vxrail.json",
"ceipEnabled" : false,
"fipsEnabled" : false,
"ntpServers" : [ "sddc-ntp-server.rainpole.local" ],
"vxManagerSpec" : {
"vxManagerHostName" : "sddcbvxrm-1",
"defaultRootUserCredentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"defaultAdminUserCredentials" : {
"username" : "mystic",
"password" : "xxxxxxxx"
}
},
"dnsSpec" : {
"subdomain" : "rainpole.local",
"domain" : "rainpole.local",
"nameserver" : "10.172.90.26"
},
"networkSpecs" : [ ],
"nsxtSpec" : {
"nsxtManagerSize" : "medium",
"nsxtManagers" : [ {
"hostname" : "sddcb-nsxt-1",
"ip" : "172.18.93.29"
}, {
"hostname" : "sddcb-nsxt-2",
"ip" : "172.18.93.41"
}, {
"hostname" : "sddcb-nsxt-3",
"ip" : "172.18.93.42"
} ],
"rootNsxtManagerPassword" : "xxxxxxxx",
"nsxtAdminPassword" : "xxxxxxxx",
"nsxtAuditPassword" : "xxxxxxxx",
"overLayTransportZone" : {
"zoneName" : "MGMT-tz-overlay01",
"networkName" : "netName-overlay"
},
"vlanTransportZone" : {
"zoneName" : "MGMT-tz-vlan01",
"networkName" : "netName-vlan"
},
"vip" : "172.18.93.36",
"vipFqdn" : "sddcb-vip-nsxt-mgmt",
"nsxtLicense" : "xxxx-xxxxx-xxxxx-xxxxx",
"transportVlanId" : 1447,
"ipAddressPoolSpec" : {
"name" : "sfo01-m01-cl01-tep01",
"description" : "ESXi Host Overlay TEP IP Pool",
"subnets" : [ {
"ipAddressPoolRanges" : [ {
"start" : "172.16.14.101",
"end" : "172.16.14.108"
} ],
"cidr" : "172.16.14.0/24",
"gateway" : "172.16.14.1"
} ]
}
},
"vsanSpec" : {
"vsanName" : "VxRail-Virtual-SAN-Cluster",
"licenseFile" : "xxxx-xxxxx-xxxxx-xxxxx",
"datastoreName" : "VxRail-Virtual-SAN-Datastore"
},
"dvsSpecs" : [ {
"dvsName" : "VMware HCIA Distributed Switch-2",
"vcenterId" : "vcenter-1",
"vmnics" : [ "vmnic1", "vmnic2" ],
"networks" : [ ],
"isUsedByNsxt" : true
} ],
"clusterSpec" : {
"clusterName" : "VxRail-Virtual-SAN-Cluster",
"vcenterName" : "vcenter-1",
"clusterEvcMode" : "",
"vmFolders" : {
"MANAGEMENT" : "MGMT-fd-mgmt",
"NETWORKING" : "MGMT-fd-nsx",
"EDGENODES" : "MGMT-fd-edge"
}
},
"pscSpecs" : [ {
"pscId" : "psc-1",
"vcenterId" : "vcenter-1",
"adminUserSsoPassword" : "xxxxxxxx",
"pscSsoSpec" : {
"ssoDomain" : "vsphere.local",
"isJoinSsoDomain" : false,
"ssoSiteName" : "MGMT"
}
} ],
"vcenterSpec" : {
"vcenterIp" : "172.18.93.26",
"vcenterHostname" : "sddcbvc-1",
"vcenterId" : "vcenter-1",
"licenseFile" : "xxxx-xxxxx-xxxxx-xxxxx",
"rootVcenterPassword" : "xxxxxxxx"
},
"hostSpecs" : [ {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.10",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-001",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-1"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.11",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-002",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-2"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.12",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-003",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-3"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.13",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-004",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-4"
} ],
"excludedComponents" : [ ]
}'
HTTP Request
POST /v1/sddcs/validations HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 4775
Host: sfo-cb01.rainpole.local
Authorization: Basic YWRtaW46Vk13YXJlSW5mcmFAMQ==
{
"skipEsxThumbprintValidation" : true,
"managementPoolName" : "",
"sddcManagerSpec" : {
"hostname" : "sddcbsddc-1",
"ipAddress" : "172.18.93.28",
"netmask" : "255.255.255.0",
"licenseKey" : "xxxx-xxxxx-xxxxx-xxxxx",
"localUserPassword" : "xxxxxxxx",
"rootUserCredentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"secondUserCredentials" : {
"username" : "vcf",
"password" : "xxxxxxxx"
}
},
"sddcId" : "MGMT",
"esxLicense" : "xxxx-xxxxx-xxxxx-xxxxx",
"taskName" : "workflowconfig/workflowspec-vxrail.json",
"ceipEnabled" : false,
"fipsEnabled" : false,
"ntpServers" : [ "sddc-ntp-server.rainpole.local" ],
"vxManagerSpec" : {
"vxManagerHostName" : "sddcbvxrm-1",
"defaultRootUserCredentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"defaultAdminUserCredentials" : {
"username" : "mystic",
"password" : "xxxxxxxx"
}
},
"dnsSpec" : {
"subdomain" : "rainpole.local",
"domain" : "rainpole.local",
"nameserver" : "10.172.90.26"
},
"networkSpecs" : [ ],
"nsxtSpec" : {
"nsxtManagerSize" : "medium",
"nsxtManagers" : [ {
"hostname" : "sddcb-nsxt-1",
"ip" : "172.18.93.29"
}, {
"hostname" : "sddcb-nsxt-2",
"ip" : "172.18.93.41"
}, {
"hostname" : "sddcb-nsxt-3",
"ip" : "172.18.93.42"
} ],
"rootNsxtManagerPassword" : "xxxxxxxx",
"nsxtAdminPassword" : "xxxxxxxx",
"nsxtAuditPassword" : "xxxxxxxx",
"overLayTransportZone" : {
"zoneName" : "MGMT-tz-overlay01",
"networkName" : "netName-overlay"
},
"vlanTransportZone" : {
"zoneName" : "MGMT-tz-vlan01",
"networkName" : "netName-vlan"
},
"vip" : "172.18.93.36",
"vipFqdn" : "sddcb-vip-nsxt-mgmt",
"nsxtLicense" : "xxxx-xxxxx-xxxxx-xxxxx",
"transportVlanId" : 1447,
"ipAddressPoolSpec" : {
"name" : "sfo01-m01-cl01-tep01",
"description" : "ESXi Host Overlay TEP IP Pool",
"subnets" : [ {
"ipAddressPoolRanges" : [ {
"start" : "172.16.14.101",
"end" : "172.16.14.108"
} ],
"cidr" : "172.16.14.0/24",
"gateway" : "172.16.14.1"
} ]
}
},
"vsanSpec" : {
"vsanName" : "VxRail-Virtual-SAN-Cluster",
"licenseFile" : "xxxx-xxxxx-xxxxx-xxxxx",
"datastoreName" : "VxRail-Virtual-SAN-Datastore"
},
"dvsSpecs" : [ {
"dvsName" : "VMware HCIA Distributed Switch-2",
"vcenterId" : "vcenter-1",
"vmnics" : [ "vmnic1", "vmnic2" ],
"networks" : [ ],
"isUsedByNsxt" : true
} ],
"clusterSpec" : {
"clusterName" : "VxRail-Virtual-SAN-Cluster",
"vcenterName" : "vcenter-1",
"clusterEvcMode" : "",
"vmFolders" : {
"MANAGEMENT" : "MGMT-fd-mgmt",
"NETWORKING" : "MGMT-fd-nsx",
"EDGENODES" : "MGMT-fd-edge"
}
},
"pscSpecs" : [ {
"pscId" : "psc-1",
"vcenterId" : "vcenter-1",
"adminUserSsoPassword" : "xxxxxxxx",
"pscSsoSpec" : {
"ssoDomain" : "vsphere.local",
"isJoinSsoDomain" : false,
"ssoSiteName" : "MGMT"
}
} ],
"vcenterSpec" : {
"vcenterIp" : "172.18.93.26",
"vcenterHostname" : "sddcbvc-1",
"vcenterId" : "vcenter-1",
"licenseFile" : "xxxx-xxxxx-xxxxx-xxxxx",
"rootVcenterPassword" : "xxxxxxxx"
},
"hostSpecs" : [ {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.10",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-001",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-1"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.11",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-002",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-2"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.12",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-003",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-3"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.13",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-004",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-4"
} ],
"excludedComponents" : [ ]
}
HTTP Response
HTTP/1.1 202 Accepted
Content-Type: application/json
Content-Length: 9106
{
"id" : "26c27804-f837-4e4f-b50f-1625af792f0f",
"executionStatus" : "COMPLETED",
"validationChecks" : [ ],
"additionalProperties" : {
"sddcSpec" : "{\n \"dvSwitchVersion\": \"7.0.0\",\n \"skipEsxThumbprintValidation\": true,\n \"managementPoolName\": \"bringup-networkpool\",\n \"sddcManagerSpec\": {\n \"hostname\": \"sfo-vcf01\",\n \"ipAddress\": \"10.0.0.4\",\n \"netmask\": \"255.255.255.0\",\n \"localUserPassword\": \"xxxxxxx\",\n \"rootUserCredentials\": {\n \"username\": \"root\",\n \"password\": \"xxxxxxx\"\n },\n \"secondUserCredentials\": {\n \"username\": \"vcf\",\n \"password\": \"xxxxxxx\"\n }\n },\n \"sddcId\": \"sddcId-public-api-01\",\n \"esxLicense\": \"XXXXX-XXXXX-XXXXX-XXXXX-XXXXX\",\n \"taskName\": \"workflowconfig/workflowspec-ems.json\",\n \"ntpServers\": [\n \"10.0.0.250\"\n ],\n \"dnsSpec\": {\n \"subdomain\": \"vrack.vsphere.local\",\n \"domain\": \"vsphere.local\",\n \"nameserver\": \"10.0.0.250\",\n \"secondaryNameserver\": \"10.0.0.250\"\n },\n \"networkSpecs\": [\n {\n \"subnet\": \"10.0.0.0/22\",\n \"vlanId\": \"0\",\n \"mtu\": \"1500\",\n \"networkType\": \"MANAGEMENT\",\n \"gateway\": \"10.0.0.250\"\n },\n {\n \"subnet\": \"10.0.4.0/24\",\n \"includeIpAddressRanges\": [\n {\n \"startIpAddress\": \"10.0.4.7\",\n \"endIpAddress\": \"10.0.4.48\"\n },\n {\n \"startIpAddress\": \"10.0.4.3\",\n \"endIpAddress\": \"10.0.4.6\"\n }\n ],\n \"includeIpAddress\": [\n \"10.0.4.50\",\n \"10.0.4.49\"\n ],\n \"vlanId\": \"0\",\n \"mtu\": \"8940\",\n \"networkType\": \"VSAN\",\n \"gateway\": \"10.0.4.253\"\n },\n {\n \"subnet\": \"10.0.8.0/24\",\n \"includeIpAddressRanges\": [\n {\n \"startIpAddress\": \"10.0.8.3\",\n \"endIpAddress\": \"10.0.8.50\"\n }\n ],\n \"vlanId\": \"0\",\n \"mtu\": \"8940\",\n \"networkType\": \"VMOTION\",\n \"gateway\": \"10.0.8.253\"\n }\n ],\n \"nsxtSpec\": {\n \"nsxtManagerSize\": \"medium\",\n \"nsxtManagers\": [\n {\n \"hostname\": \"sfo-m01-nsx01a\",\n \"ip\": \"10.0.0.31\"\n },\n {\n \"hostname\": \"sfo-m01-nsx01b\",\n \"ip\": \"10.0.0.32\"\n },\n {\n \"hostname\": \"sfo-m01-nsx01c\",\n \"ip\": \"10.0.0.33\"\n }\n ],\n \"rootNsxtManagerPassword\": \"xxxxxxx\",\n \"nsxtAdminPassword\": \"xxxxxxx\",\n \"nsxtAuditPassword\": \"xxxxxxx\",\n \"overLayTransportZone\": {\n \"zoneName\": \"sfo-m01-tz-overlay01\",\n \"networkName\": \"net-overlay\"\n },\n \"vlanTransportZone\": {\n \"zoneName\": \"sfo-m01-tz-vlan01\",\n \"networkName\": \"net-vlan\"\n },\n \"vip\": \"10.0.0.30\",\n \"vipFqdn\": \"sfo-m01-nsx01\",\n \"nsxtLicense\": \"XXXXX-XXXXX-XXXXX-XXXXX-XXXXX\",\n \"transportVlanId\": 0,\n \"ipAddressPoolSpec\": {\n \"name\": \"sfo01-m01-cl01-tep01\",\n \"description\": \"ESXi Host Overlay TEP IP Pool\",\n \"subnets\": [\n {\n \"ipAddressPoolRanges\": [\n {\n \"start\": \"172.16.14.101\",\n \"end\": \"172.16.14.108\"\n }\n ],\n \"cidr\": \"172.16.14.0/24\",\n \"gateway\": \"172.16.14.1\"\n }\n ]\n }\n },\n \"vsanSpec\": {\n \"vsanName\": \"sfo-m01-cl01-ds-vsan01\",\n \"licenseFile\": \"XXXXX-XXXXX-XXXXX-XXXXX-XXXXX\",\n \"datastoreName\": \"sfo-m01-cl01-ds-vsan01\"\n },\n \"dvsSpecs\": [\n {\n \"mtu\": 8940,\n \"niocSpecs\": [\n {\n \"trafficType\": \"VSAN\",\n \"value\": \"HIGH\"\n },\n {\n \"trafficType\": \"VMOTION\",\n \"value\": \"LOW\"\n },\n {\n \"trafficType\": \"VDP\",\n \"value\": \"LOW\"\n },\n {\n \"trafficType\": \"VIRTUALMACHINE\",\n \"value\": \"HIGH\"\n },\n {\n \"trafficType\": \"MANAGEMENT\",\n \"value\": \"NORMAL\"\n },\n {\n \"trafficType\": \"NFS\",\n \"value\": \"LOW\"\n },\n {\n \"trafficType\": \"HBR\",\n \"value\": \"LOW\"\n },\n {\n \"trafficType\": \"FAULTTOLERANCE\",\n \"value\": \"LOW\"\n },\n {\n \"trafficType\": \"ISCSI\",\n \"value\": \"LOW\"\n }\n ],\n \"dvsName\": \"sfo-m01-cl01-vds01\",\n \"vmnics\": [\n \"vmnic0\",\n \"vmnic1\"\n ],\n \"networks\": [\n \"MANAGEMENT\",\n \"VSAN\",\n \"VMOTION\"\n ]\n }\n ],\n \"clusterSpec\": {\n \"clusterName\": \"sfo-m01-cl01\",\n \"clusterEvcMode\": \"\",\n \"resourcePoolSpecs\": [\n {\n \"cpuSharesLevel\": \"high\",\n \"cpuSharesValue\": 0,\n \"name\": \"sfo-m01-cl01-rp-sddc-mgmt\",\n \"memorySharesValue\": 0,\n \"cpuReservationPercentage\": 0,\n \"memoryLimit\": -1,\n \"memoryReservationPercentage\": 0,\n \"cpuReservationExpandable\": true,\n \"memoryReservationExpandable\": true,\n \"memorySharesLevel\": \"normal\",\n \"cpuLimit\": -1,\n \"type\": \"management\"\n },\n {\n \"cpuSharesLevel\": \"high\",\n \"cpuSharesValue\": 0,\n \"name\": \"sfo-m01-cl01-rp-sddc-network\",\n \"memorySharesValue\": 0,\n \"cpuReservationPercentage\": 0,\n \"memoryLimit\": -1,\n \"memoryReservationPercentage\": 0,\n \"cpuReservationExpandable\": true,\n \"memoryReservationExpandable\": true,\n \"memorySharesLevel\": \"normal\",\n \"cpuLimit\": -1,\n \"type\": \"network\"\n },\n {\n \"cpuSharesLevel\": \"normal\",\n \"cpuSharesValue\": 0,\n \"name\": \"sfo-m01-cl01-rp-sddc-compute\",\n \"memorySharesValue\": 0,\n \"cpuReservationPercentage\": 0,\n \"memoryLimit\": -1,\n \"memoryReservationPercentage\": 0,\n \"cpuReservationExpandable\": true,\n \"memoryReservationExpandable\": true,\n \"memorySharesLevel\": \"normal\",\n \"cpuLimit\": -1,\n \"type\": \"compute\"\n },\n {\n \"name\": \"sfo-m01-cl01-rp-user-compute\",\n \"type\": \"compute\",\n \"cpuReservationMhz\": 2100,\n \"cpuLimit\": -1,\n \"cpuReservationExpandable\": true,\n \"cpuSharesLevel\": \"normal\",\n \"memoryReservationMb\": 3128,\n \"memoryReservationExpandable\": true,\n \"memorySharesLevel\": \"normal\",\n \"memorySharesValue\": 0\n }\n ]\n },\n \"pscSpecs\": [\n {\n \"pscId\": \"psc-1\",\n \"pscSsoSpec\": {\n \"ssoDomain\": \"vsphere.local\"\n },\n \"adminUserSsoPassword\": \"xxxxxxx\"\n }\n ],\n \"vcenterSpec\": {\n \"vcenterIp\": \"10.0.0.6\",\n \"vcenterHostname\": \"sfo-m01-vc01\",\n \"licenseFile\": \"XXXXX-XXXXX-XXXXX-XXXXX-XXXXX\",\n \"rootVcenterPassword\": \"xxxxxxx\",\n \"vmSize\": \"tiny\"\n },\n \"hostSpecs\": [\n {\n \"credentials\": {\n \"username\": \"root\",\n \"password\": \"xxxxxxx\"\n },\n \"ipAddressPrivate\": {\n \"subnet\": \"255.255.252.0\",\n \"cidr\": \"\",\n \"ipAddress\": \"10.0.0.100\",\n \"gateway\": \"10.0.0.250\"\n },\n \"hostname\": \"sfo01-m01-esx01\",\n \"vSwitch\": \"vSwitch0\",\n \"serverId\": \"host-0\",\n \"association\": \"sfo-m01-dc01\"\n },\n {\n \"credentials\": {\n \"username\": \"root\",\n \"password\": \"xxxxxxx\"\n },\n \"ipAddressPrivate\": {\n \"subnet\": \"255.255.252.0\",\n \"cidr\": \"\",\n \"ipAddress\": \"10.0.0.101\",\n \"gateway\": \"10.0.0.250\"\n },\n \"hostname\": \"sfo01-m01-esx02\",\n \"vSwitch\": \"vSwitch0\",\n \"serverId\": \"host-1\",\n \"association\": \"sfo-m01-dc01\"\n },\n {\n \"credentials\": {\n \"username\": \"root\",\n \"password\": \"xxxxxxx\"\n },\n \"ipAddressPrivate\": {\n \"subnet\": \"255.255.255.0\",\n \"cidr\": \"\",\n \"ipAddress\": \"10.0.0.102\",\n \"gateway\": \"10.0.0.250\"\n },\n \"hostname\": \"sfo01-m01-esx03\",\n \"vSwitch\": \"vSwitch0\",\n \"serverId\": \"host-2\",\n \"association\": \"sfo-m01-dc01\"\n },\n {\n \"credentials\": {\n \"username\": \"root\",\n \"password\": \"xxxxxxx\"\n },\n \"ipAddressPrivate\": {\n \"subnet\": \"255.255.255.0\",\n \"cidr\": \"\",\n \"ipAddress\": \"10.0.0.103\",\n \"gateway\": \"10.0.0.250\"\n },\n \"hostname\": \"sfo01-m01-esx04\",\n \"vSwitch\": \"vSwitch0\",\n \"serverId\": \"host-3\",\n \"association\": \"sfo-m01-dc01\"\n }\n ]\n}\n"
}
}
-
Poll the task until “executionStatus” is not “IN_PROGRESS” using the “id” from the previous response.
-
In case of no errors in the input specification, the “executionStatus” is “COMPLETED” and “resultStatus” is
“SUCCEEDED”.
-
In case of errors in the input specification, the “executionStatus” is “COMPLETED” and “resultStatus” is
“FAILED”.
-
Validate the input specification.
Note : Make changes to the input specification and re-validate using a new API invocation.
- Download the validation report (optional).
cURL Request
$ curl 'https://sfo-cb01.rainpole.local/v1/sddcs/validations/4672d251-b124-433e-aead-6135e4042439/report' -i -u 'admin:VMwareInfra@1' -X GET \
-H 'Content-Type: application/octet-stream'
HTTP Request
GET /v1/sddcs/validations/4672d251-b124-433e-aead-6135e4042439/report HTTP/1.1
Content-Type: application/octet-stream
Host: sfo-cb01.rainpole.local
Authorization: Basic YWRtaW46Vk13YXJlSW5mcmFAMQ==
HTTP Response
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: form-data; name="validation-report-26c27804-f837-4e4f-b50f-1625af792f0f"; filename="validation-report-26c27804-f837-4e4f-b50f-1625af792f0f"
Note : The report can be downloaded while the “executionStatus” is “IN_PROGRESS” or “COMPLETED” and the “resultStatus” is “SUCCEEDED” or “FAILED”.
- Trigger the task using the valid input specification
cURL Request
$ curl 'https://sfo-cb01.rainpole.local/v1/sddcs' -i -u 'admin:VMwareInfra@1' -X POST \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
"skipEsxThumbprintValidation" : true,
"managementPoolName" : "",
"sddcManagerSpec" : {
"hostname" : "sddcbsddc-1",
"ipAddress" : "172.18.93.28",
"netmask" : "255.255.255.0",
"licenseKey" : "xxxx-xxxxx-xxxxx-xxxxx",
"localUserPassword" : "xxxxxxxx",
"rootUserCredentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"secondUserCredentials" : {
"username" : "vcf",
"password" : "xxxxxxxx"
}
},
"sddcId" : "MGMT",
"esxLicense" : "xxxx-xxxxx-xxxxx-xxxxx",
"taskName" : "workflowconfig/workflowspec-vxrail.json",
"ceipEnabled" : false,
"fipsEnabled" : false,
"ntpServers" : [ "sddc-ntp-server.rainpole.local" ],
"vxManagerSpec" : {
"vxManagerHostName" : "sddcbvxrm-1",
"defaultRootUserCredentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"defaultAdminUserCredentials" : {
"username" : "mystic",
"password" : "xxxxxxxx"
}
},
"dnsSpec" : {
"subdomain" : "rainpole.local",
"domain" : "rainpole.local",
"nameserver" : "10.172.90.26"
},
"networkSpecs" : [ ],
"nsxtSpec" : {
"nsxtManagerSize" : "medium",
"nsxtManagers" : [ {
"hostname" : "sddcb-nsxt-1",
"ip" : "172.18.93.29"
}, {
"hostname" : "sddcb-nsxt-2",
"ip" : "172.18.93.41"
}, {
"hostname" : "sddcb-nsxt-3",
"ip" : "172.18.93.42"
} ],
"rootNsxtManagerPassword" : "xxxxxxxx",
"nsxtAdminPassword" : "xxxxxxxx",
"nsxtAuditPassword" : "xxxxxxxx",
"overLayTransportZone" : {
"zoneName" : "MGMT-tz-overlay01",
"networkName" : "netName-overlay"
},
"vlanTransportZone" : {
"zoneName" : "MGMT-tz-vlan01",
"networkName" : "netName-vlan"
},
"vip" : "172.18.93.36",
"vipFqdn" : "sddcb-vip-nsxt-mgmt",
"nsxtLicense" : "xxxx-xxxxx-xxxxx-xxxxx",
"transportVlanId" : 1447,
"ipAddressPoolSpec" : {
"name" : "sfo01-m01-cl01-tep01",
"description" : "ESXi Host Overlay TEP IP Pool",
"subnets" : [ {
"ipAddressPoolRanges" : [ {
"start" : "172.16.14.101",
"end" : "172.16.14.108"
} ],
"cidr" : "172.16.14.0/24",
"gateway" : "172.16.14.1"
} ]
}
},
"vsanSpec" : {
"vsanName" : "VxRail-Virtual-SAN-Cluster",
"licenseFile" : "xxxx-xxxxx-xxxxx-xxxxx",
"datastoreName" : "VxRail-Virtual-SAN-Datastore"
},
"dvsSpecs" : [ {
"dvsName" : "VMware HCIA Distributed Switch-2",
"vcenterId" : "vcenter-1",
"vmnics" : [ "vmnic1", "vmnic2" ],
"networks" : [ ],
"isUsedByNsxt" : true
} ],
"clusterSpec" : {
"clusterName" : "VxRail-Virtual-SAN-Cluster",
"vcenterName" : "vcenter-1",
"clusterEvcMode" : "",
"vmFolders" : {
"MANAGEMENT" : "MGMT-fd-mgmt",
"NETWORKING" : "MGMT-fd-nsx",
"EDGENODES" : "MGMT-fd-edge"
}
},
"pscSpecs" : [ {
"pscId" : "psc-1",
"vcenterId" : "vcenter-1",
"adminUserSsoPassword" : "xxxxxxxx",
"pscSsoSpec" : {
"ssoDomain" : "vsphere.local",
"isJoinSsoDomain" : false,
"ssoSiteName" : "MGMT"
}
} ],
"vcenterSpec" : {
"vcenterIp" : "172.18.93.26",
"vcenterHostname" : "sddcbvc-1",
"vcenterId" : "vcenter-1",
"licenseFile" : "xxxx-xxxxx-xxxxx-xxxxx",
"rootVcenterPassword" : "xxxxxxxx"
},
"hostSpecs" : [ {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.10",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-001",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-1"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.11",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-002",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-2"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.12",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-003",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-3"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.13",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-004",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-4"
} ],
"excludedComponents" : [ ]
}'
HTTP Request
POST /v1/sddcs HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 4775
Host: sfo-cb01.rainpole.local
Authorization: Basic YWRtaW46Vk13YXJlSW5mcmFAMQ==
{
"skipEsxThumbprintValidation" : true,
"managementPoolName" : "",
"sddcManagerSpec" : {
"hostname" : "sddcbsddc-1",
"ipAddress" : "172.18.93.28",
"netmask" : "255.255.255.0",
"licenseKey" : "xxxx-xxxxx-xxxxx-xxxxx",
"localUserPassword" : "xxxxxxxx",
"rootUserCredentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"secondUserCredentials" : {
"username" : "vcf",
"password" : "xxxxxxxx"
}
},
"sddcId" : "MGMT",
"esxLicense" : "xxxx-xxxxx-xxxxx-xxxxx",
"taskName" : "workflowconfig/workflowspec-vxrail.json",
"ceipEnabled" : false,
"fipsEnabled" : false,
"ntpServers" : [ "sddc-ntp-server.rainpole.local" ],
"vxManagerSpec" : {
"vxManagerHostName" : "sddcbvxrm-1",
"defaultRootUserCredentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"defaultAdminUserCredentials" : {
"username" : "mystic",
"password" : "xxxxxxxx"
}
},
"dnsSpec" : {
"subdomain" : "rainpole.local",
"domain" : "rainpole.local",
"nameserver" : "10.172.90.26"
},
"networkSpecs" : [ ],
"nsxtSpec" : {
"nsxtManagerSize" : "medium",
"nsxtManagers" : [ {
"hostname" : "sddcb-nsxt-1",
"ip" : "172.18.93.29"
}, {
"hostname" : "sddcb-nsxt-2",
"ip" : "172.18.93.41"
}, {
"hostname" : "sddcb-nsxt-3",
"ip" : "172.18.93.42"
} ],
"rootNsxtManagerPassword" : "xxxxxxxx",
"nsxtAdminPassword" : "xxxxxxxx",
"nsxtAuditPassword" : "xxxxxxxx",
"overLayTransportZone" : {
"zoneName" : "MGMT-tz-overlay01",
"networkName" : "netName-overlay"
},
"vlanTransportZone" : {
"zoneName" : "MGMT-tz-vlan01",
"networkName" : "netName-vlan"
},
"vip" : "172.18.93.36",
"vipFqdn" : "sddcb-vip-nsxt-mgmt",
"nsxtLicense" : "xxxx-xxxxx-xxxxx-xxxxx",
"transportVlanId" : 1447,
"ipAddressPoolSpec" : {
"name" : "sfo01-m01-cl01-tep01",
"description" : "ESXi Host Overlay TEP IP Pool",
"subnets" : [ {
"ipAddressPoolRanges" : [ {
"start" : "172.16.14.101",
"end" : "172.16.14.108"
} ],
"cidr" : "172.16.14.0/24",
"gateway" : "172.16.14.1"
} ]
}
},
"vsanSpec" : {
"vsanName" : "VxRail-Virtual-SAN-Cluster",
"licenseFile" : "xxxx-xxxxx-xxxxx-xxxxx",
"datastoreName" : "VxRail-Virtual-SAN-Datastore"
},
"dvsSpecs" : [ {
"dvsName" : "VMware HCIA Distributed Switch-2",
"vcenterId" : "vcenter-1",
"vmnics" : [ "vmnic1", "vmnic2" ],
"networks" : [ ],
"isUsedByNsxt" : true
} ],
"clusterSpec" : {
"clusterName" : "VxRail-Virtual-SAN-Cluster",
"vcenterName" : "vcenter-1",
"clusterEvcMode" : "",
"vmFolders" : {
"MANAGEMENT" : "MGMT-fd-mgmt",
"NETWORKING" : "MGMT-fd-nsx",
"EDGENODES" : "MGMT-fd-edge"
}
},
"pscSpecs" : [ {
"pscId" : "psc-1",
"vcenterId" : "vcenter-1",
"adminUserSsoPassword" : "xxxxxxxx",
"pscSsoSpec" : {
"ssoDomain" : "vsphere.local",
"isJoinSsoDomain" : false,
"ssoSiteName" : "MGMT"
}
} ],
"vcenterSpec" : {
"vcenterIp" : "172.18.93.26",
"vcenterHostname" : "sddcbvc-1",
"vcenterId" : "vcenter-1",
"licenseFile" : "xxxx-xxxxx-xxxxx-xxxxx",
"rootVcenterPassword" : "xxxxxxxx"
},
"hostSpecs" : [ {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.10",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-001",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-1"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.11",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-002",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-2"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.12",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-003",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-3"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.13",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-004",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-4"
} ],
"excludedComponents" : [ ]
}
HTTP Response
HTTP/1.1 202 Accepted
Location: /v1/sddcs/97f5c5fe-187f-46d3-b446-73e310187428
Content-Type: application/json
Content-Length: 2497
{
"id" : "97f5c5fe-187f-46d3-b446-73e310187428",
"name" : "Bringup",
"status" : "IN_PROGRESS",
"creationTimestamp" : "2019-12-09T15:32:22.300Z",
"sddcSubTasks" : [ {
"sddcId" : "97f5c5fe-187f-46d3-b446-73e310187428",
"processingStateName" : "_VCDeployment_VcPlugin_DeployVcAction_4",
"processingStateDescription" : "Deploy vCenter Server",
"name" : "Deploy vCenter Server",
"description" : "Deploy vCenter Server",
"localizableNamePack" : {
"component" : "com.vmware.vcf.common.fsm.plugins.action.plugins.VcPlugin",
"messageKey" : "DeployVcAction.name"
},
"localizableDescriptionPack" : {
"component" : "com.vmware.vcf.common.fsm.plugins.action.plugins.VcPlugin",
"messageKey" : "DeployVcAction.desc"
},
"status" : "INITIALIZED",
"creationTimestamp" : "2019-12-09T15:32:21.942Z",
"updateTimestamp" : "2019-12-09T15:32:21.942Z"
}, {
"sddcId" : "97f5c5fe-187f-46d3-b446-73e310187428",
"processingStateName" : "NSXConfiguration",
"processingStateDescription" : "Deploy and Configure NSX",
"name" : "Deploy NSX Manager",
"description" : "Deploy and Configure NSX for vSphere",
"localizableNamePack" : {
"component" : "com.vmware.evo.sddc.bringup.nsx.action63.NsxServicePluginActionPlugin63",
"messageKey" : "DeployNsxManager.name"
},
"localizableDescriptionPack" : {
"component" : "com.vmware.evo.sddc.bringup.nsx.action63.NsxServicePluginActionPlugin63",
"messageKey" : "DeployNsxManager.desc"
},
"status" : "INITIALIZED",
"creationTimestamp" : "2019-12-09T15:32:22.012Z",
"updateTimestamp" : "2019-12-09T15:32:22.012Z"
}, {
"sddcId" : "97f5c5fe-187f-46d3-b446-73e310187428",
"processingStateName" : "_SDDCManagerConfiguration_SddcManagerContractPlugin_DeploySddcManagerOnClusterAction_1",
"processingStateDescription" : "Deploy SDDC Manager",
"name" : "Deploy SDDC Manager",
"description" : "Deploy SDDC Manager",
"localizableNamePack" : {
"component" : "com.vmware.evo.sddc.sddcmanager.SddcManagerContractPlugin",
"messageKey" : "DeploySddcManagerOnClusterAction.name"
},
"localizableDescriptionPack" : {
"component" : "com.vmware.evo.sddc.sddcmanager.SddcManagerContractPlugin",
"messageKey" : "DeploySddcManagerOnClusterAction.desc"
},
"status" : "INITIALIZED",
"creationTimestamp" : "2019-12-09T15:32:22.083Z",
"updateTimestamp" : "2019-12-09T15:32:22.083Z"
} ]
}
- Poll the task until “status” is not “IN_PROGRESS” using the “id” from the previous response.
Tip : Refer to: Get an SDDC.
-
If the “status” is “COMPLETED_WITH_SUCCESS”, the task is completed successfully.
-
If the “status” is “COMPLETED_WITH_FAILURE”, the task can be re-executed.
Tip : Refer to: Retry an SDDC creation.
2. Get the SDDCS
2.1. Steps
- Invoke the API.
cURL Request
$ curl 'https://sfo-cb01.rainpole.local/v1/sddcs' -i -u 'admin:VMwareInfra@1' -X GET
HTTP Request
GET /v1/sddcs HTTP/1.1
Host: sfo-cb01.rainpole.local
Authorization: Basic YWRtaW46Vk13YXJlSW5mcmFAMQ==
HTTP Response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2634
{
"elements" : [ {
"id" : "97f5c5fe-187f-46d3-b446-73e310187428",
"name" : "Bringup",
"status" : "IN_PROGRESS",
"creationTimestamp" : "2019-12-09T15:32:22.300Z",
"sddcSubTasks" : [ {
"sddcId" : "97f5c5fe-187f-46d3-b446-73e310187428",
"processingStateName" : "_VCDeployment_VcPlugin_DeployVcAction_4",
"processingStateDescription" : "Deploy vCenter Server",
"name" : "Deploy vCenter Server",
"description" : "Deploy vCenter Server",
"localizableNamePack" : {
"component" : "com.vmware.vcf.common.fsm.plugins.action.plugins.VcPlugin",
"messageKey" : "DeployVcAction.name"
},
"localizableDescriptionPack" : {
"component" : "com.vmware.vcf.common.fsm.plugins.action.plugins.VcPlugin",
"messageKey" : "DeployVcAction.desc"
},
"status" : "INITIALIZED",
"creationTimestamp" : "2019-12-09T15:32:21.942Z",
"updateTimestamp" : "2019-12-09T15:32:21.942Z"
}, {
"sddcId" : "97f5c5fe-187f-46d3-b446-73e310187428",
"processingStateName" : "NSXConfiguration",
"processingStateDescription" : "Deploy and Configure NSX",
"name" : "Deploy NSX Manager",
"description" : "Deploy and Configure NSX for vSphere",
"localizableNamePack" : {
"component" : "com.vmware.evo.sddc.bringup.nsx.action63.NsxServicePluginActionPlugin63",
"messageKey" : "DeployNsxManager.name"
},
"localizableDescriptionPack" : {
"component" : "com.vmware.evo.sddc.bringup.nsx.action63.NsxServicePluginActionPlugin63",
"messageKey" : "DeployNsxManager.desc"
},
"status" : "INITIALIZED",
"creationTimestamp" : "2019-12-09T15:32:22.012Z",
"updateTimestamp" : "2019-12-09T15:32:22.012Z"
}, {
"sddcId" : "97f5c5fe-187f-46d3-b446-73e310187428",
"processingStateName" : "_SDDCManagerConfiguration_SddcManagerContractPlugin_DeploySddcManagerOnClusterAction_1",
"processingStateDescription" : "Deploy SDDC Manager",
"name" : "Deploy SDDC Manager",
"description" : "Deploy SDDC Manager",
"localizableNamePack" : {
"component" : "com.vmware.evo.sddc.sddcmanager.SddcManagerContractPlugin",
"messageKey" : "DeploySddcManagerOnClusterAction.name"
},
"localizableDescriptionPack" : {
"component" : "com.vmware.evo.sddc.sddcmanager.SddcManagerContractPlugin",
"messageKey" : "DeploySddcManagerOnClusterAction.desc"
},
"status" : "INITIALIZED",
"creationTimestamp" : "2019-12-09T15:32:22.083Z",
"updateTimestamp" : "2019-12-09T15:32:22.083Z"
} ]
} ]
}
3. Get an SDDC
3.1. Prerequisites
The following data is required
- ID of the SDDC
3.2. Steps
- Invoke the API.
cURL Request
$ curl 'https://sfo-cb01.rainpole.local/v1/sddcs/97f5c5fe-187f-46d3-b446-73e310187428' -i -u 'admin:VMwareInfra@1' -X GET \
-H 'Accept: application/json'
HTTP Request
GET /v1/sddcs/97f5c5fe-187f-46d3-b446-73e310187428 HTTP/1.1
Accept: application/json
Host: sfo-cb01.rainpole.local
Authorization: Basic YWRtaW46Vk13YXJlSW5mcmFAMQ==
HTTP Response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2497
{
"id" : "97f5c5fe-187f-46d3-b446-73e310187428",
"name" : "Bringup",
"status" : "IN_PROGRESS",
"creationTimestamp" : "2019-12-09T15:32:22.300Z",
"sddcSubTasks" : [ {
"sddcId" : "97f5c5fe-187f-46d3-b446-73e310187428",
"processingStateName" : "_VCDeployment_VcPlugin_DeployVcAction_4",
"processingStateDescription" : "Deploy vCenter Server",
"name" : "Deploy vCenter Server",
"description" : "Deploy vCenter Server",
"localizableNamePack" : {
"component" : "com.vmware.vcf.common.fsm.plugins.action.plugins.VcPlugin",
"messageKey" : "DeployVcAction.name"
},
"localizableDescriptionPack" : {
"component" : "com.vmware.vcf.common.fsm.plugins.action.plugins.VcPlugin",
"messageKey" : "DeployVcAction.desc"
},
"status" : "INITIALIZED",
"creationTimestamp" : "2019-12-09T15:32:21.942Z",
"updateTimestamp" : "2019-12-09T15:32:21.942Z"
}, {
"sddcId" : "97f5c5fe-187f-46d3-b446-73e310187428",
"processingStateName" : "NSXConfiguration",
"processingStateDescription" : "Deploy and Configure NSX",
"name" : "Deploy NSX Manager",
"description" : "Deploy and Configure NSX for vSphere",
"localizableNamePack" : {
"component" : "com.vmware.evo.sddc.bringup.nsx.action63.NsxServicePluginActionPlugin63",
"messageKey" : "DeployNsxManager.name"
},
"localizableDescriptionPack" : {
"component" : "com.vmware.evo.sddc.bringup.nsx.action63.NsxServicePluginActionPlugin63",
"messageKey" : "DeployNsxManager.desc"
},
"status" : "INITIALIZED",
"creationTimestamp" : "2019-12-09T15:32:22.012Z",
"updateTimestamp" : "2019-12-09T15:32:22.012Z"
}, {
"sddcId" : "97f5c5fe-187f-46d3-b446-73e310187428",
"processingStateName" : "_SDDCManagerConfiguration_SddcManagerContractPlugin_DeploySddcManagerOnClusterAction_1",
"processingStateDescription" : "Deploy SDDC Manager",
"name" : "Deploy SDDC Manager",
"description" : "Deploy SDDC Manager",
"localizableNamePack" : {
"component" : "com.vmware.evo.sddc.sddcmanager.SddcManagerContractPlugin",
"messageKey" : "DeploySddcManagerOnClusterAction.name"
},
"localizableDescriptionPack" : {
"component" : "com.vmware.evo.sddc.sddcmanager.SddcManagerContractPlugin",
"messageKey" : "DeploySddcManagerOnClusterAction.desc"
},
"status" : "INITIALIZED",
"creationTimestamp" : "2019-12-09T15:32:22.083Z",
"updateTimestamp" : "2019-12-09T15:32:22.083Z"
} ]
}
4. Retry an SDDC creation
Used to retry a failed SDDC creation task/workflow.
4.1. Prerequisites
The following data is required
- ID of the failed task
The following data is optional
- SDDC deployment details
Tip : Refer to: SddcSpec.
Note : If the SDDC creation details are provided retry of the SDDC creation is performed with the updated information.
4.2. Steps
- Invoke the API without providing SDDC creation details
cURL Request
$ curl 'https://sfo-cb01.rainpole.local/v1/sddcs/b285bfc6-8ef2-48d3-a8e2-4ccf921b1f1a' -i -u 'admin:VMwareInfra@1' -X PATCH \
-H 'Accept: application/json'
HTTP Request
PATCH /v1/sddcs/b285bfc6-8ef2-48d3-a8e2-4ccf921b1f1a HTTP/1.1
Accept: application/json
Host: sfo-cb01.rainpole.local
Authorization: Basic YWRtaW46Vk13YXJlSW5mcmFAMQ==
HTTP Response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2497
{
"id" : "97f5c5fe-187f-46d3-b446-73e310187428",
"name" : "Bringup",
"status" : "IN_PROGRESS",
"creationTimestamp" : "2019-12-09T15:32:22.300Z",
"sddcSubTasks" : [ {
"sddcId" : "97f5c5fe-187f-46d3-b446-73e310187428",
"processingStateName" : "_VCDeployment_VcPlugin_DeployVcAction_4",
"processingStateDescription" : "Deploy vCenter Server",
"name" : "Deploy vCenter Server",
"description" : "Deploy vCenter Server",
"localizableNamePack" : {
"component" : "com.vmware.vcf.common.fsm.plugins.action.plugins.VcPlugin",
"messageKey" : "DeployVcAction.name"
},
"localizableDescriptionPack" : {
"component" : "com.vmware.vcf.common.fsm.plugins.action.plugins.VcPlugin",
"messageKey" : "DeployVcAction.desc"
},
"status" : "INITIALIZED",
"creationTimestamp" : "2019-12-09T15:32:21.942Z",
"updateTimestamp" : "2019-12-09T15:32:21.942Z"
}, {
"sddcId" : "97f5c5fe-187f-46d3-b446-73e310187428",
"processingStateName" : "NSXConfiguration",
"processingStateDescription" : "Deploy and Configure NSX",
"name" : "Deploy NSX Manager",
"description" : "Deploy and Configure NSX for vSphere",
"localizableNamePack" : {
"component" : "com.vmware.evo.sddc.bringup.nsx.action63.NsxServicePluginActionPlugin63",
"messageKey" : "DeployNsxManager.name"
},
"localizableDescriptionPack" : {
"component" : "com.vmware.evo.sddc.bringup.nsx.action63.NsxServicePluginActionPlugin63",
"messageKey" : "DeployNsxManager.desc"
},
"status" : "INITIALIZED",
"creationTimestamp" : "2019-12-09T15:32:22.012Z",
"updateTimestamp" : "2019-12-09T15:32:22.012Z"
}, {
"sddcId" : "97f5c5fe-187f-46d3-b446-73e310187428",
"processingStateName" : "_SDDCManagerConfiguration_SddcManagerContractPlugin_DeploySddcManagerOnClusterAction_1",
"processingStateDescription" : "Deploy SDDC Manager",
"name" : "Deploy SDDC Manager",
"description" : "Deploy SDDC Manager",
"localizableNamePack" : {
"component" : "com.vmware.evo.sddc.sddcmanager.SddcManagerContractPlugin",
"messageKey" : "DeploySddcManagerOnClusterAction.name"
},
"localizableDescriptionPack" : {
"component" : "com.vmware.evo.sddc.sddcmanager.SddcManagerContractPlugin",
"messageKey" : "DeploySddcManagerOnClusterAction.desc"
},
"status" : "INITIALIZED",
"creationTimestamp" : "2019-12-09T15:32:22.083Z",
"updateTimestamp" : "2019-12-09T15:32:22.083Z"
} ]
}
- Invoke the API by providing SDDC creation details
cURL Request
$ curl 'https://sfo-cb01.rainpole.local/v1/sddcs/b285bfc6-8ef2-48d3-a8e2-4ccf921b1f1a' -i -u 'admin:VMwareInfra@1' -X PATCH \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
"skipEsxThumbprintValidation" : true,
"managementPoolName" : "",
"sddcManagerSpec" : {
"hostname" : "sddcbsddc-1",
"ipAddress" : "172.18.93.28",
"netmask" : "255.255.255.0",
"licenseKey" : "xxxx-xxxxx-xxxxx-xxxxx",
"localUserPassword" : "xxxxxxxx",
"rootUserCredentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"secondUserCredentials" : {
"username" : "vcf",
"password" : "xxxxxxxx"
}
},
"sddcId" : "MGMT",
"esxLicense" : "xxxx-xxxxx-xxxxx-xxxxx",
"taskName" : "workflowconfig/workflowspec-vxrail.json",
"ceipEnabled" : false,
"fipsEnabled" : false,
"ntpServers" : [ "sddc-ntp-server.rainpole.local" ],
"vxManagerSpec" : {
"vxManagerHostName" : "sddcbvxrm-1",
"defaultRootUserCredentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"defaultAdminUserCredentials" : {
"username" : "mystic",
"password" : "xxxxxxxx"
}
},
"dnsSpec" : {
"subdomain" : "rainpole.local",
"domain" : "rainpole.local",
"nameserver" : "10.172.90.26"
},
"networkSpecs" : [ ],
"nsxtSpec" : {
"nsxtManagerSize" : "medium",
"nsxtManagers" : [ {
"hostname" : "sddcb-nsxt-1",
"ip" : "172.18.93.29"
}, {
"hostname" : "sddcb-nsxt-2",
"ip" : "172.18.93.41"
}, {
"hostname" : "sddcb-nsxt-3",
"ip" : "172.18.93.42"
} ],
"rootNsxtManagerPassword" : "xxxxxxxx",
"nsxtAdminPassword" : "xxxxxxxx",
"nsxtAuditPassword" : "xxxxxxxx",
"overLayTransportZone" : {
"zoneName" : "MGMT-tz-overlay01",
"networkName" : "netName-overlay"
},
"vlanTransportZone" : {
"zoneName" : "MGMT-tz-vlan01",
"networkName" : "netName-vlan"
},
"vip" : "172.18.93.36",
"vipFqdn" : "sddcb-vip-nsxt-mgmt",
"nsxtLicense" : "xxxx-xxxxx-xxxxx-xxxxx",
"transportVlanId" : 1447,
"ipAddressPoolSpec" : {
"name" : "sfo01-m01-cl01-tep01",
"description" : "ESXi Host Overlay TEP IP Pool",
"subnets" : [ {
"ipAddressPoolRanges" : [ {
"start" : "172.16.14.101",
"end" : "172.16.14.108"
} ],
"cidr" : "172.16.14.0/24",
"gateway" : "172.16.14.1"
} ]
}
},
"vsanSpec" : {
"vsanName" : "VxRail-Virtual-SAN-Cluster",
"licenseFile" : "xxxx-xxxxx-xxxxx-xxxxx",
"datastoreName" : "VxRail-Virtual-SAN-Datastore"
},
"dvsSpecs" : [ {
"dvsName" : "VMware HCIA Distributed Switch-2",
"vcenterId" : "vcenter-1",
"vmnics" : [ "vmnic1", "vmnic2" ],
"networks" : [ ],
"isUsedByNsxt" : true
} ],
"clusterSpec" : {
"clusterName" : "VxRail-Virtual-SAN-Cluster",
"vcenterName" : "vcenter-1",
"clusterEvcMode" : "",
"vmFolders" : {
"MANAGEMENT" : "MGMT-fd-mgmt",
"NETWORKING" : "MGMT-fd-nsx",
"EDGENODES" : "MGMT-fd-edge"
}
},
"pscSpecs" : [ {
"pscId" : "psc-1",
"vcenterId" : "vcenter-1",
"adminUserSsoPassword" : "xxxxxxxx",
"pscSsoSpec" : {
"ssoDomain" : "vsphere.local",
"isJoinSsoDomain" : false,
"ssoSiteName" : "MGMT"
}
} ],
"vcenterSpec" : {
"vcenterIp" : "172.18.93.26",
"vcenterHostname" : "sddcbvc-1",
"vcenterId" : "vcenter-1",
"licenseFile" : "xxxx-xxxxx-xxxxx-xxxxx",
"rootVcenterPassword" : "xxxxxxxx"
},
"hostSpecs" : [ {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.10",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-001",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-1"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.11",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-002",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-2"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.12",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-003",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-3"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.13",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-004",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-4"
} ],
"excludedComponents" : [ ]
}'
HTTP Request
PATCH /v1/sddcs/b285bfc6-8ef2-48d3-a8e2-4ccf921b1f1a HTTP/1.1
Content-Type: application/json
Accept: application/json
Content-Length: 4775
Host: sfo-cb01.rainpole.local
Authorization: Basic YWRtaW46Vk13YXJlSW5mcmFAMQ==
{
"skipEsxThumbprintValidation" : true,
"managementPoolName" : "",
"sddcManagerSpec" : {
"hostname" : "sddcbsddc-1",
"ipAddress" : "172.18.93.28",
"netmask" : "255.255.255.0",
"licenseKey" : "xxxx-xxxxx-xxxxx-xxxxx",
"localUserPassword" : "xxxxxxxx",
"rootUserCredentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"secondUserCredentials" : {
"username" : "vcf",
"password" : "xxxxxxxx"
}
},
"sddcId" : "MGMT",
"esxLicense" : "xxxx-xxxxx-xxxxx-xxxxx",
"taskName" : "workflowconfig/workflowspec-vxrail.json",
"ceipEnabled" : false,
"fipsEnabled" : false,
"ntpServers" : [ "sddc-ntp-server.rainpole.local" ],
"vxManagerSpec" : {
"vxManagerHostName" : "sddcbvxrm-1",
"defaultRootUserCredentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"defaultAdminUserCredentials" : {
"username" : "mystic",
"password" : "xxxxxxxx"
}
},
"dnsSpec" : {
"subdomain" : "rainpole.local",
"domain" : "rainpole.local",
"nameserver" : "10.172.90.26"
},
"networkSpecs" : [ ],
"nsxtSpec" : {
"nsxtManagerSize" : "medium",
"nsxtManagers" : [ {
"hostname" : "sddcb-nsxt-1",
"ip" : "172.18.93.29"
}, {
"hostname" : "sddcb-nsxt-2",
"ip" : "172.18.93.41"
}, {
"hostname" : "sddcb-nsxt-3",
"ip" : "172.18.93.42"
} ],
"rootNsxtManagerPassword" : "xxxxxxxx",
"nsxtAdminPassword" : "xxxxxxxx",
"nsxtAuditPassword" : "xxxxxxxx",
"overLayTransportZone" : {
"zoneName" : "MGMT-tz-overlay01",
"networkName" : "netName-overlay"
},
"vlanTransportZone" : {
"zoneName" : "MGMT-tz-vlan01",
"networkName" : "netName-vlan"
},
"vip" : "172.18.93.36",
"vipFqdn" : "sddcb-vip-nsxt-mgmt",
"nsxtLicense" : "xxxx-xxxxx-xxxxx-xxxxx",
"transportVlanId" : 1447,
"ipAddressPoolSpec" : {
"name" : "sfo01-m01-cl01-tep01",
"description" : "ESXi Host Overlay TEP IP Pool",
"subnets" : [ {
"ipAddressPoolRanges" : [ {
"start" : "172.16.14.101",
"end" : "172.16.14.108"
} ],
"cidr" : "172.16.14.0/24",
"gateway" : "172.16.14.1"
} ]
}
},
"vsanSpec" : {
"vsanName" : "VxRail-Virtual-SAN-Cluster",
"licenseFile" : "xxxx-xxxxx-xxxxx-xxxxx",
"datastoreName" : "VxRail-Virtual-SAN-Datastore"
},
"dvsSpecs" : [ {
"dvsName" : "VMware HCIA Distributed Switch-2",
"vcenterId" : "vcenter-1",
"vmnics" : [ "vmnic1", "vmnic2" ],
"networks" : [ ],
"isUsedByNsxt" : true
} ],
"clusterSpec" : {
"clusterName" : "VxRail-Virtual-SAN-Cluster",
"vcenterName" : "vcenter-1",
"clusterEvcMode" : "",
"vmFolders" : {
"MANAGEMENT" : "MGMT-fd-mgmt",
"NETWORKING" : "MGMT-fd-nsx",
"EDGENODES" : "MGMT-fd-edge"
}
},
"pscSpecs" : [ {
"pscId" : "psc-1",
"vcenterId" : "vcenter-1",
"adminUserSsoPassword" : "xxxxxxxx",
"pscSsoSpec" : {
"ssoDomain" : "vsphere.local",
"isJoinSsoDomain" : false,
"ssoSiteName" : "MGMT"
}
} ],
"vcenterSpec" : {
"vcenterIp" : "172.18.93.26",
"vcenterHostname" : "sddcbvc-1",
"vcenterId" : "vcenter-1",
"licenseFile" : "xxxx-xxxxx-xxxxx-xxxxx",
"rootVcenterPassword" : "xxxxxxxx"
},
"hostSpecs" : [ {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.10",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-001",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-1"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.11",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-002",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-2"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.12",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-003",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-3"
}, {
"association" : "VxRail-Datacenter",
"ipAddressPrivate" : {
"ipAddress" : "172.18.93.13",
"cidr" : "172.18.93.0/24",
"gateway" : "172.18.93.1"
},
"hostname" : "sddcb-004",
"credentials" : {
"username" : "root",
"password" : "xxxxxxxx"
},
"vSwitch" : "",
"serverId" : "host-4"
} ],
"excludedComponents" : [ ]
}
HTTP Response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2497
{
"id" : "97f5c5fe-187f-46d3-b446-73e310187428",
"name" : "Bringup",
"status" : "IN_PROGRESS",
"creationTimestamp" : "2019-12-09T15:32:22.300Z",
"sddcSubTasks" : [ {
"sddcId" : "97f5c5fe-187f-46d3-b446-73e310187428",
"processingStateName" : "_VCDeployment_VcPlugin_DeployVcAction_4",
"processingStateDescription" : "Deploy vCenter Server",
"name" : "Deploy vCenter Server",
"description" : "Deploy vCenter Server",
"localizableNamePack" : {
"component" : "com.vmware.vcf.common.fsm.plugins.action.plugins.VcPlugin",
"messageKey" : "DeployVcAction.name"
},
"localizableDescriptionPack" : {
"component" : "com.vmware.vcf.common.fsm.plugins.action.plugins.VcPlugin",
"messageKey" : "DeployVcAction.desc"
},
"status" : "INITIALIZED",
"creationTimestamp" : "2019-12-09T15:32:21.942Z",
"updateTimestamp" : "2019-12-09T15:32:21.942Z"
}, {
"sddcId" : "97f5c5fe-187f-46d3-b446-73e310187428",
"processingStateName" : "NSXConfiguration",
"processingStateDescription" : "Deploy and Configure NSX",
"name" : "Deploy NSX Manager",
"description" : "Deploy and Configure NSX for vSphere",
"localizableNamePack" : {
"component" : "com.vmware.evo.sddc.bringup.nsx.action63.NsxServicePluginActionPlugin63",
"messageKey" : "DeployNsxManager.name"
},
"localizableDescriptionPack" : {
"component" : "com.vmware.evo.sddc.bringup.nsx.action63.NsxServicePluginActionPlugin63",
"messageKey" : "DeployNsxManager.desc"
},
"status" : "INITIALIZED",
"creationTimestamp" : "2019-12-09T15:32:22.012Z",
"updateTimestamp" : "2019-12-09T15:32:22.012Z"
}, {
"sddcId" : "97f5c5fe-187f-46d3-b446-73e310187428",
"processingStateName" : "_SDDCManagerConfiguration_SddcManagerContractPlugin_DeploySddcManagerOnClusterAction_1",
"processingStateDescription" : "Deploy SDDC Manager",
"name" : "Deploy SDDC Manager",
"description" : "Deploy SDDC Manager",
"localizableNamePack" : {
"component" : "com.vmware.evo.sddc.sddcmanager.SddcManagerContractPlugin",
"messageKey" : "DeploySddcManagerOnClusterAction.name"
},
"localizableDescriptionPack" : {
"component" : "com.vmware.evo.sddc.sddcmanager.SddcManagerContractPlugin",
"messageKey" : "DeploySddcManagerOnClusterAction.desc"
},
"status" : "INITIALIZED",
"creationTimestamp" : "2019-12-09T15:32:22.083Z",
"updateTimestamp" : "2019-12-09T15:32:22.083Z"
} ]
}
Last updated 2023-04-27 11:11:39 PDT