---
title: "Resetting an OVHcloud Managed Kubernetes cluster"
description: "OVHcloud Managed Kubernetes service provides you with Kubernetes clusters without the hassle of installing or operating them."
url: https://docs.us.ovhcloud.com/en/public-cloud/managed-kubernetes/reset-cluster
lang: en
---
> For AI agents: the complete documentation index is available at https://docs.us.ovhcloud.com/en/llms.txt, the full documentation bundle is available at https://docs.us.ovhcloud.com/en/llms-full.txt.

# Resetting an OVHcloud Managed Kubernetes cluster

OVHcloud Managed Kubernetes service provides you with Kubernetes clusters without the hassle of installing or operating them.

During a reset, all data in the ETCD will be deleted (pods, deployments, services, secrets, CRDs, etc.). Similarly, load balancers and all PVCs (Persistent Volume Claim) with their PCI cinder volumes will be deleted. Nodes will be either deleted or reinstalled (depending on the option you set during the reset).

The whole cluster configuration is reset, but some values can be defined (optional):

- workerNodesPolicy: reinstall|delete
- minor\_version: for ex. 1.25
- updatePolicy: "ALWAYS\_UPDATE" by default
- customization: API Server & kube proxy configuration
- privateNetworkId: private network openstack UUID
- privateNetworkConfiguration: true|false
- defaultVrackGateway: gateway IP
- kubeProxyMode: ipvs|iptables

 

## Requirements

- An [OVHcloud Managed Kubernetes](https://us.ovhcloud.com/public-cloud/kubernetes/) cluster
- Access to the [OVHcloud Control Panel](https://manager.us.ovhcloud.com/) or [OVHcloud API](https://api.us.ovhcloud.com/)

 

## Instructions

### Reset a Kubernetes cluster on the OVHcloud Control Panel

#### Step 1 - Ask for cluster reset on the OVHcloud Control Panel

Log in to the [OVHcloud Control Panel](https://manager.us.ovhcloud.com/), go to the `Public Cloud` section, and select the Public Cloud project concerned.

Click `Managed Kubernetes Service` in the left-hand menu and select your **Cluster's name**.

In the `Service` tab, click `Reset your cluster` in the **Management** panel.

 

#### Step 2 - Choose the type of reset you want

You have two options on the reset menu: _Delete_ and _Reinstall_.

- Choosing `Delete nodes` means that the current cluster nodes are deleted, and the cluster is reinitialized to an empty state.
- Choosing `Keep and reinstall nodes` means that the cluster is reinitialized without destroying the nodes.

You can also choose the minor version of the cluster and the private network attached to it.

Click the `Confirm` button to continue.

 

#### Step 3 - Wait for the resetting to end

Depending on the chosen reset type, the process can take several minutes. During that time, a message in the OVHcloud Control Panel warns you that the cluster is resetting.

 

### Reset a Kubernetes cluster through the API

#### Access the OVHcloud API

Log in to the [OVHcloud API](https://api.us.ovhcloud.com/) and navigate to the /kubernetes section.

If you go to the [Kubernetes section](https://api.us.ovhcloud.com/console/?section=%2Fcloud\&branch=v1#get-/cloud/project/-serviceName-/kube) of the API Explorer, you will see the available endpoints:

 

#### API endpoints

- Reset a Kubernetes cluster:

  `POST /cloud/project/{serviceName}/kube/{kubeId}/reset`

**Input:**

```
{
  "name": "my-test-cluster",
  "updatePolicy": "ALWAYS_UPDATE",
  "version": "1.34"
}
```

**Result:**

```
null
```

By default, if you don't specify it, the `workerNodesPolicy` option will be equivalent to `delete`. If you want your Nodes reinstalled, rather than deleted, you have to specify `"workerNodesPolicy": "reinstall"`.

You should receive a response with `null` content. This message will be improved in the future with the same information you have after a Kubernetes cluster creation.

- Check the Kubernetes cluster is resetting:

  `GET /cloud/project/{serviceName}/kube/{kubeId}`

**Result:**

```
{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
  "region": "US-EAST-VA-1",
  "name": "my-test-cluster",
  "url": "xxxxxx.c1.va1.k8s.ovh.us",
  "nodesUrl": "xxxxxx.nodes.c1.va1.k8s.ovh.us",
  "version": "1.34.2",
  "nextUpgradeVersions": [],
  "kubeProxyMode": "iptables",
  "customization": {
    "apiServer": {
      "admissionPlugins": {
        "enabled": [
          "AlwaysPullImages",
          "NodeRestriction"
        ],
        "disabled": []
      }
    }
  },
  "status": "REDEPLOYING",
  "updatePolicy": "ALWAYS_UPDATE",
  "isUpToDate": true,
  "controlPlaneIsUpToDate": true,
  "privateNetworkId": null,
  "createdAt": "2023-03-21T10:53:35Z",
  "updatedAt": "2023-03-22T09:16:34Z"
}
```

 

## Go further

Browse all the [Managed Kubernetes Service (MKS) guides](https://docs.us.ovhcloud.com/en/public-cloud/managed-kubernetes/landing-page-managed-kubernetes.md).

Browse the rest of the [OVHcloud US documentation](https://docs.us.ovhcloud.com/en/index.md) for guides on our other products and services.

Learn more about [Managed Kubernetes](https://us.ovhcloud.com/public-cloud/kubernetes/) on the OVHcloud US website.

If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](https://us.ovhcloud.com/professional-services/) to get a quote and ask our Professional Services experts for a custom analysis of your project.