Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Administración de clústeres virtuales
<a name="virtual-cluster"></a>

Un clúster virtual es un espacio de nombres de Kubernetes en el que Amazon EMR está registrado. Puede crear, describir, enumerar y eliminar clústeres virtuales. No consumen recursos adicionales en el sistema. Un único clúster virtual se asigna a un único espacio de nombres Kubernetes. Dada esta relación, puede modelar clústeres virtuales de la misma manera que modela los espacios de nombres Kubernetes para satisfacer sus necesidades. Consulte los posibles casos de uso en la documentación de [información general de conceptos de Kubernetes](https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/). 

Para registrar Amazon EMR con un espacio de nombres de Kubernetes en un clúster de Amazon EKS, necesita el nombre del clúster de EKS y el espacio de nombres que se ha configurado para ejecutar su carga de trabajo. Estos clústeres registrados en Amazon EMR se denominan clústeres virtuales porque no administran la computación física ni el almacenamiento, sino que apuntan a un espacio de nombres de Kubernetes en el que está programada la carga de trabajo.

**nota**  
Antes de crear un clúster virtual, debe completar los pasos del 1 al 8 que se indican en [Configuración de Amazon EMR en EKS](setting-up.md).

**Topics**
+ [Crear un clúster virtual](#create-virtul-cluster)
+ [Enumerar los clústeres virtuales](#list-virtual-cluster)
+ [Describir un clúster virtual](#describe-virtual-cluster)
+ [Eliminar un clúster virtual](#delete-virtual-cluster)
+ [Estados del clúster virtual](#virtual-cluster-states)

## Crear un clúster virtual
<a name="create-virtul-cluster"></a>

Ejecute el siguiente comando para crear un clúster virtual mediante el registro de Amazon EMR con un espacio de nombres en un clúster de EKS. *virtual\$1cluster\$1name*Sustitúyalo por un nombre que proporcione para el clúster virtual. *eks\$1cluster\$1name*Sustitúyalo por el nombre del clúster de EKS. Sustituya el por el espacio de nombres *namespace\$1name* con el que desee registrar Amazon EMR.

```
aws emr-containers create-virtual-cluster \
--name virtual_cluster_name \
--container-provider '{
    "id": "eks_cluster_name",
    "type": "EKS",
    "info": {
        "eksInfo": {
            "namespace": "namespace_name"
        }
    }
}'
```

Como alternativa, puede crear un archivo JSON que incluya los parámetros necesarios para el clúster virtual, tal como se muestra en el siguiente ejemplo.

```
{
    "name": "virtual_cluster_name", 
    "containerProvider": {
        "type": "EKS", 
        "id": "eks_cluster_name", 
        "info": {
            "eksInfo": {
                "namespace": "namespace_name"
            }
        }
    }
}
```

A continuación, ejecute el comando `create-virtual-cluster` con la ruta al archivo JSON.

```
aws emr-containers create-virtual-cluster \
--cli-input-json file://./create-virtual-cluster-request.json
```

**nota**  
Para validar la creación correcta de un clúster virtual, consulte el estado de los clústeres virtuales mediante la ejecución del comando `list-virtual-clusters` o en la página **Clústeres virtuales** de la consola de Amazon EMR.

## Enumerar los clústeres virtuales
<a name="list-virtual-cluster"></a>

Para ver el estado de los clústeres virtuales, ejecute el siguiente comando. 

```
aws emr-containers list-virtual-clusters
```

## Describir un clúster virtual
<a name="describe-virtual-cluster"></a>

Ejecute el siguiente comando para obtener más detalles sobre un clúster virtual, como el espacio de nombres, el estado y la fecha de registro. *123456*Sustitúyalo por el ID de su clúster virtual. 

```
aws emr-containers describe-virtual-cluster --id 123456
```

## Eliminar un clúster virtual
<a name="delete-virtual-cluster"></a>

Ejecute el siguiente comando para eliminar un clúster virtual. *123456*Sustitúyalo por tu ID de clúster virtual.

```
aws emr-containers delete-virtual-cluster --id 123456
```

## Estados del clúster virtual
<a name="virtual-cluster-states"></a>

En la siguiente tabla, se describen los cuatro estados posibles de un clúster virtual.


| `State` | Description (Descripción) | 
| --- | --- | 
|  `RUNNING`  | El estado del clúster virtual es RUNNING.  | 
|  `TERMINATING`  | La terminación del clúster virtual solicitada está en curso. | 
|  `TERMINATED`  | La terminación solicitada se ha completado. | 
|  `ARRESTED`  | Se ha producido un error en la terminación solicitada debido a la insuficiencia de permisos. |