

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Abilitazione dell'API REST Slurm nei PCS AWS
<a name="slurm-rest-api-enable"></a>

Abilita l'API REST Slurm per accedere all'interfaccia HTTP del cluster per la gestione e il monitoraggio programmatici dei lavori. È possibile abilitare questa funzionalità durante la creazione del cluster o aggiornare un cluster esistente che soddisfi i requisiti.

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

Prima di abilitare l'API REST di Slurm, assicurati di avere:
+ **Versione cluster**: Slurm versione 25.05 o successiva.
+ **Gruppo di sicurezza**: regole che consentono il traffico HTTP sulla porta 6820 dalle sorgenti desiderate.

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

**Per abilitare l'API REST di Slurm su un nuovo cluster**

------
#### [ Console di gestione AWS ]

1. Apri la console AWS PCS all'indirizzo. [https://console.aws.amazon.com/pcs/](https://console.aws.amazon.com/pcs/)

1. Scegli **Crea cluster**.

1. In **Dettagli del cluster**, scegli Slurm versione 25.05 o successiva.

1. Configura le altre impostazioni del cluster secondo necessità.

1. Nella sezione di **configurazione Scheduler**, imposta l'**API REST** su **Enabled**.

1. Configura il gruppo di sicurezza del cluster per consentire il traffico HTTP sulla porta 6820 dalle sorgenti desiderate.

1. Completa il processo di creazione del cluster.

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

1. Aggiungi una configurazione Slurm REST durante la creazione del cluster.

   ```
   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. Configura il gruppo di sicurezza del cluster per consentire il traffico HTTP sulla porta 6820 dalle sorgenti desiderate.

------

**Per abilitare l'API REST di Slurm su un cluster esistente**

------
#### [ Console di gestione AWS ]

1. Apri la console AWS PCS all'indirizzo. [https://console.aws.amazon.com/pcs/](https://console.aws.amazon.com/pcs/)

1. Scegli il tuo cluster dall'elenco.

1. Verifica che il tuo cluster utilizzi Slurm versione 25.05 o successiva nei dettagli del cluster.

1. **Scegli Modifica cluster.**

1. Nella sezione di **configurazione Scheduler**, imposta l'**API REST** su **Enabled**.

1. Scegli **Aggiorna cluster** per applicare le modifiche.

1. Configura il gruppo di sicurezza del cluster per consentire il traffico HTTP sulla porta 6820 dalle sorgenti desiderate.

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

1. Aggiorna il tuo cluster con una configurazione Slurm REST, come in questo esempio.

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

1. Configura il gruppo di sicurezza del cluster per consentire il traffico HTTP sulla porta 6820 dalle sorgenti desiderate.

------

## Cosa succede dopo l'attivazione
<a name="slurm-rest-api-enable-results"></a>

Quando abiliti l'API REST, AWS PCS automaticamente:
+ Genera una chiave di firma JWT e la memorizza in AWS Secrets Manager.
+ Espone l'endpoint dell'API all'`https://<clusterPrivateIpAddress>:6820`interno del tuo VPC.
+ Aggiorna la configurazione del cluster per mostrare i dettagli dell'endpoint dell'API REST.

Ora puoi autenticare e utilizzare l'API REST per la gestione dei lavori e le operazioni del cluster.