Add a cluster to a specific SDDC.

Prerequisites

  • If you want to add a cluster with NFS enabled, verify that the NFS mount is active.
  • You must have the required privileges to perform this task.

Procedure

  • Send the following POST request to the server. The session ID is sent in the header and the host specification is sent in the body of the request.
    https://{{server_ip}}:9443/api/v1/sddc/1/clusters/{{cluster_name}}
    curl --location --request DELETE "https://{{server_ip}}:9443/api/v1/sddc/1/clusters/SEC_CLU" \
      --header "Content-Type: application/json" \
      --header "JSESSIONID: {{JSESSIONID}}" \
      --data "{...}"
    

Results

A successful call returns the ID with the status:
{
    "task_id": "1"
}

Example: Body of the Request With and Without NFS

With NFS:

{
    "nfsSpec": {
        "nfsDatastoreClusterName": "NFS_DS_CLU",
        "nfsDatastores": [
            {
                "localPath": "NFS-1",
                "remoteIp": "192.168.101.11",
                "remoteMountPath": "/data/nfs1/",
                "accessMode": "readWrite"
            }
        ]
    },
	"clusterSpec": {
				
		  "name": "SECONDARY",
		  "vsanClusterSpec": {
		    "deduplication": true,
		    "compression": true
		  },
		  "evcMode": "disabled",
		  "hosts": [
		    {
		      "username": "root",
		      "password": "Skoda1!",
		      "type": "SECONDARY",
		      "vmknicSpecs": {
		        "vsan": {
		          "ipSpec": {
		            "ip": "192.168.103.101",
		            "subnet": "255.255.255.0",
		            "gw": "192.168.103.1"
		          },
		          "type": "VSAN",
		          "name": "vmk1",
		          "vlanId": 0
		        },
		        "esxiMgmt": {
		          "ipSpec": {
		            "ip": "192.168.101.101",
		            "subnet": "255.255.255.0",
		            "fqdn": "esxmb1.cloud.vmw",
		            "gw": "192.168.101.1"
		          },
		          "type": "ESXi_MGMT",
		          "name": "vmk0",
		          "vlanId": 0
		        },
		        "vmotion": {
		          "ipSpec": {
		            "ip": "192.168.102.101",
		            "subnet": "255.255.255.0",
		            "gw": "192.168.102.1"
		          },
		          "type": "VMOTION_PG",
		          "name": "vmk2",
		          "vlanId": 0
		        },
		        "nfs": {
		          "ipSpec": {
		            "ip": "192.168.104.101",
		            "subnet": "255.255.255.0",
		            "gw": "192.168.104.1"
		          },
		          "type": "NFS",
		          "name": "vmk3",
		          "vlanId": 0
		        }
		      },
		      "pnicSpec": {
		        "uplink1": {
		          "name": "vmnic0"
		        },
		        "uplink2": {
		          "name": "vmnic1"
		        }
		      },
		      "vsanDiskSpec": {
		        "autoDiskGroups": true,
		        "diskGroups": []
		      }
		    },
		    {
		      "username": "root",
		      "password": "Skoda1!",
		      "type": "SECONDARY",
		      "vmknicSpecs": {
		        "vsan": {
		          "ipSpec": {
		            "ip": "192.168.103.102",
		            "subnet": "255.255.255.0",
		            "gw": "192.168.103.1"
		          },
		          "type": "VSAN",
		          "name": "vmk1",
		          "vlanId": 0
		        },
		        "esxiMgmt": {
		          "ipSpec": {
		            "ip": "192.168.101.102",
		            "subnet": "255.255.255.0",
		            "fqdn": "esxmb2.cloud.vmw",
		            "gw": "192.168.101.1"
		          },
		          "type": "ESXi_MGMT",
		          "name": "vmk0",
		          "vlanId": 0
		        },
		        "vmotion": {
		          "ipSpec": {
		            "ip": "192.168.102.102",
		            "subnet": "255.255.255.0",
		            "gw": "192.168.102.1"
		          },
		          "type": "VMOTION_PG",
		          "name": "vmk2",
		          "vlanId": 0
		        },
		        "nfs": {
		          "ipSpec": {
		            "ip": "192.168.104.102",
		            "subnet": "255.255.255.0",
		            "gw": "192.168.104.1"
		          },
		          "type": "NFS",
		          "name": "vmk3",
		          "vlanId": 0
		        }
		      },
		      "pnicSpec": {
		        "uplink1": {
		          "name": "vmnic0"
		        },
		        "uplink2": {
		          "name": "vmnic1"
		        }
		      },
		      "vsanDiskSpec": {
		        "autoDiskGroups": true,
		        "diskGroups": []
		      }
		    },
		    {
		      "username": "root",
		      "password": "Skoda1!",
		      "type": "SECONDARY",
		      "vmknicSpecs": {
		        "vsan": {
		          "ipSpec": {
		            "ip": "192.168.103.103",
		            "subnet": "255.255.255.0",
		            "gw": "192.168.103.1"
		          },
		          "type": "VSAN",
		          "name": "vmk1",
		          "vlanId": 0
		        },
		        "esxiMgmt": {
		          "ipSpec": {
		            "ip": "192.168.101.103",
		            "subnet": "255.255.255.0",
		            "fqdn": "esxmb3.cloud.vmw",
		            "gw": "192.168.101.1"
		          },
		          "type": "ESXi_MGMT",
		          "name": "vmk0",
		          "vlanId": 0
		        },
		        "vmotion": {
		          "ipSpec": {
		            "ip": "192.168.102.103",
		            "subnet": "255.255.255.0",
		            "gw": "192.168.102.1"
		          },
		          "type": "VMOTION_PG",
		          "name": "vmk2",
		          "vlanId": 0
		        },
		        "nfs": {
		          "ipSpec": {
		            "ip": "192.168.104.103",
		            "subnet": "255.255.255.0",
		            "gw": "192.168.104.1"
		          },
		          "type": "NFS",
		          "name": "vmk3",
		          "vlanId": 0
		        }
		      },
		      "pnicSpec": {
		        "uplink1": {
		          "name": "vmnic0"
		        },
		        "uplink2": {
		          "name": "vmnic1"
		        }
		      },
		      "vsanDiskSpec": {
		        "autoDiskGroups": true,
		        "diskGroups": []
		      }
		    }
		  ]
		}
}

Without NFS:

{
"clusterSpec": {
		
  "name": "SECONDARY",
  "vsanClusterSpec": {
    "deduplication": true,
    "compression": true
  },
  "evcMode": "disabled",
  "hosts": [
    {
      "username": "root",
      "password": "Skoda1!",
      "type": "SECONDARY",
      "vmknicSpecs": {
        "vsan": {
          "ipSpec": {
            "ip": "192.168.103.101",
            "subnet": "255.255.255.0",
            "gw": "192.168.103.1"
          },
          "type": "VSAN",
          "name": "vmk1",
          "vlanId": 0
        },
        "esxiMgmt": {
          "ipSpec": {
            "ip": "192.168.101.101",
            "subnet": "255.255.255.0",
            "fqdn": "esxmb1.cloud.vmw",
            "gw": "192.168.101.1"
          },
          "type": "ESXi_MGMT",
          "name": "vmk0",
          "vlanId": 0
        },
        "vmotion": {
          "ipSpec": {
            "ip": "192.168.102.101",
            "subnet": "255.255.255.0",
            "gw": "192.168.102.1"
          },
          "type": "VMOTION_PG",
          "name": "vmk2",
          "vlanId": 0
        }
      },
      "pnicSpec": {
        "uplink1": {
          "name": "vmnic0"
        },
        "uplink2": {
          "name": "vmnic1"
        }
      },
      "vsanDiskSpec": {
        "autoDiskGroups": true,
        "diskGroups": []
      }
    },
    {
      "username": "root",
      "password": "Skoda1!",
      "type": "SECONDARY",
      "vmknicSpecs": {
        "vsan": {
          "ipSpec": {
            "ip": "192.168.103.102",
            "subnet": "255.255.255.0",
            "gw": "192.168.103.1"
          },
          "type": "VSAN",
          "name": "vmk1",
          "vlanId": 0
        },
        "esxiMgmt": {
          "ipSpec": {
            "ip": "192.168.101.102",
            "subnet": "255.255.255.0",
            "fqdn": "esxmb2.cloud.vmw",
            "gw": "192.168.101.1"
          },
          "type": "ESXi_MGMT",
          "name": "vmk0",
          "vlanId": 0
        },
        "vmotion": {
          "ipSpec": {
            "ip": "192.168.102.102",
            "subnet": "255.255.255.0",
            "gw": "192.168.102.1"
          },
          "type": "VMOTION_PG",
          "name": "vmk2",
          "vlanId": 0
        }
      },
      "pnicSpec": {
        "uplink1": {
          "name": "vmnic0"
        },
        "uplink2": {
          "name": "vmnic1"
        }
      },
      "vsanDiskSpec": {
        "autoDiskGroups": true,
        "diskGroups": []
      }
    },
    {
      "username": "root",
      "password": "Skoda1!",
      "type": "SECONDARY",
      "vmknicSpecs": {
        "vsan": {
          "ipSpec": {
            "ip": "192.168.103.103",
            "subnet": "255.255.255.0",
            "gw": "192.168.103.1"
          },
          "type": "VSAN",
          "name": "vmk1",
          "vlanId": 0
        },
        "esxiMgmt": {
          "ipSpec": {
            "ip": "192.168.101.103",
            "subnet": "255.255.255.0",
            "fqdn": "esxmb3.cloud.vmw",
            "gw": "192.168.101.1"
          },
          "type": "ESXi_MGMT",
          "name": "vmk0",
          "vlanId": 0
        },
        "vmotion": {
          "ipSpec": {
            "ip": "192.168.102.103",
            "subnet": "255.255.255.0",
            "gw": "192.168.102.1"
          },
          "type": "VMOTION_PG",
          "name": "vmk2",
          "vlanId": 0
        }
      },
      "pnicSpec": {
        "uplink1": {
          "name": "vmnic0"
        },
        "uplink2": {
          "name": "vmnic1"
        }
      },
      "vsanDiskSpec": {
        "autoDiskGroups": true,
        "diskGroups": []
      }
    }
  ]
}	
}