**Ayude a mejorar esta página** 

Para contribuir a esta guía del usuario, elija el enlace **Edit this page on GitHub** que se encuentra en el panel derecho de cada página.

# Anulación del registro de un clúster de Kubernetes desde la consola de Amazon EKS
<a name="deregister-connected-cluster"></a>

Si ya ha terminado de usar un clúster conectado, puede anular su registro. Una vez que se anule el registro, el clúster ya no estará visible en la consola de Amazon EKS.

Debe tener los siguientes permisos para llamar a la API deregisterCluster:
+  `eks:DeregisterCluster` 
+  `ssm:DeleteActivation` 
+  `ssm:DeregisterManagedInstance` 

Este proceso consta de dos pasos: anular el registro del clúster en Amazon EKS y desinstalar el agente eks-connector del clúster.

## Anulación del registro del clúster de Kubernetes
<a name="deregister-connected-cluster-eks"></a>

Para anular el registro de un clúster del conector Amazon EKS, puede utilizar una de estas herramientas:
+  [AWS CLI](#awscli_deregister_cluster_connect) 
+  [Consola de administración de AWS](#console_deregister_cluster_connect) 
+  [`eksctl`](#eksctl_deregister_cluster_connect) 

### AWS CLI
<a name="awscli_deregister_cluster_connect"></a>

1.  La CLI de AWS debe estar instalada. Para instalarla o actualizarla, consulte [Instalación de la CLI de AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html).

1. Asegúrese de que se haya creado el rol de agente de Amazon EKS Connector.

1. Anule el registro del clúster conectado.

   ```
   aws eks deregister-cluster \
       --name my-cluster \
       --region region-code
   ```

### Consola de administración de AWS
<a name="console_deregister_cluster_connect"></a>

1. Abra la [consola de Amazon EKS](https://console.aws.amazon.com/eks/home#/clusters).

1. Seleccione **Clusters (Clústeres)**.

1. En la página **Clusters (Clústeres)**, seleccione el clúster conectado y seleccione **Deregister (Anular registro)**.

1. Confirme que desea anular el registro del clúster.

### `eksctl`
<a name="eksctl_deregister_cluster_connect"></a>

1. Instale la versión de `eksctl` `0.68` o una posterior. Para instalarla o actualizarla, consulte [Introducción a Amazon EKS: `eksctl`](getting-started-eksctl.md).

1. Asegúrese de que se haya creado el rol de agente de Amazon EKS Connector.

1. Anule el registro del clúster conectado:

   ```
   eksctl deregister cluster --name my-cluster
   ```

## Limpieza de los recursos del clúster de Kubernetes
<a name="deregister-connected-cluster-k8s"></a>

Para desinstalar el agente de `eks-connector`, utilice uno de los siguientes comandos:
+  [helm](#helm_agent_cluster_deregister) 
+  [yaml](#yaml_agent_cluster_deregister) 

### helm
<a name="helm_agent_cluster_deregister"></a>

Ejecute el siguiente comando para desinstalar el agente.

```
helm -n eks-connector uninstall eks-connector
```

### yaml
<a name="yaml_agent_cluster_deregister"></a>

1. Elimine el archivo YAML de Amazon EKS Connector del clúster de Kubernetes.

   ```
   kubectl delete -f eks-connector.yaml
   ```

1. Si ha creado un `clusterrole` o `clusterrolebindings` para que [entidades principales](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#iam-term-principal) de IAM adicionales accedan al clúster, asegúrese de eliminarlas del clúster de Kubernetes.