Remove a cluster within a specific SDDC.

Prerequisites

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

Procedure

  • Send the following DELETE 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/SEC_CLU
    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:

{
  "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:

{
  "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": []
      }
    }
  ]
}