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.

# Habilitación de la API REST de Slurm en PCS AWS
<a name="slurm-rest-api-enable"></a>

Habilite la API REST de Slurm para acceder a la interfaz HTTP de su clúster para gestionar y supervisar los trabajos mediante programación. Puede habilitar esta función durante la creación del clúster o actualizar un clúster existente que cumpla con los requisitos.

## Requisitos previos
<a name="slurm-rest-api-enable-prerequisites"></a>

Antes de habilitar la API REST de Slurm, asegúrate de tener:
+ **Versión de clúster**: Slurm, versión 25.05 o superior.
+ **Grupo de seguridad**: reglas que permiten el tráfico HTTP en el puerto 6820 desde las fuentes deseadas.

## Procedimiento
<a name="slurm-rest-api-enable-procedure"></a>

**Para habilitar la API REST de Slurm en un clúster nuevo**

------
#### [ Consola de administración de AWS ]

1. Abra la consola AWS PCS en. [https://console.aws.amazon.com/pcs/](https://console.aws.amazon.com/pcs/)

1. Elija **Create cluster**.

1. En **Detalles del clúster**, seleccione Slurm, versión 25.05 o superior.

1. Configure los demás ajustes del clúster según sea necesario.

1. En la sección de **configuración del programador**, establece la **API REST** en **Habilitada**.

1. Configure el grupo de seguridad del clúster para permitir el tráfico HTTP en el puerto 6820 desde las fuentes que desee.

1. Complete el proceso de creación del clúster.

------
#### [ AWS CLI ]

1. Agregue una configuración REST de Slurm al crear el clúster.

   ```
   aws pcs create-cluster --region region \
       --cluster-name my-cluster \
       --scheduler type=SLURM, version=25.05 \
       --size SMALL \
       --networking subnetIds=subnet-ExampleId1,securityGroupIds=sg-ExampleId1 \
       --slurm-configuration slurmRest='{mode=STANDARD}'
   ```

1. Configure el grupo de seguridad del clúster para permitir el tráfico HTTP en el puerto 6820 desde las fuentes que desee.

------

**Para habilitar la API REST de Slurm en un clúster existente**

------
#### [ Consola de administración de AWS ]

1. Abra la consola AWS PCS en. [https://console.aws.amazon.com/pcs/](https://console.aws.amazon.com/pcs/)

1. Elija su clúster de la lista.

1. Compruebe que su clúster utilice la versión 25.05 o superior de Slurm en los detalles del clúster.

1. **Seleccione Editar clúster.**

1. En la sección de **configuración del programador**, establece la **API REST** en **Habilitada**.

1. Seleccione **Actualizar clúster** para aplicar los cambios.

1. Configure el grupo de seguridad del clúster para permitir el tráfico HTTP en el puerto 6820 desde las fuentes que desee.

------
#### [ AWS CLI ]

1. Actualice el clúster con una configuración REST de Slurm, como en este ejemplo.

   ```
   aws pcs update-cluster --cluster-identifier my-cluster \
       --slurm-configuration 'slurmRest={mode=STANDARD}'
   ```

1. Configure el grupo de seguridad del clúster para permitir el tráfico HTTP en el puerto 6820 desde las fuentes que desee.

------

## ¿Qué sucede después de habilitarlo
<a name="slurm-rest-api-enable-results"></a>

Al habilitar la API REST, AWS PCS automáticamente:
+ Genera una clave de firma JWT y la almacena en AWS Secrets Manager.
+ Expone el punto final de la API `https://<clusterPrivateIpAddress>:6820` dentro de su VPC.
+ Actualiza la configuración del clúster para mostrar los detalles del punto final de la API REST.

Ahora puedes autenticar y usar la API REST para la administración de trabajos y las operaciones de clúster.