As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Habilitando a API REST do Slurm no PCS AWS
<a name="slurm-rest-api-enable"></a>

Ative a API REST do Slurm para acessar a interface HTTP do seu cluster para gerenciamento e monitoramento programáticos de tarefas. Você pode ativar esse recurso durante a criação do cluster ou atualizar um cluster existente que atenda aos requisitos.

## Pré-requisitos
<a name="slurm-rest-api-enable-prerequisites"></a>

Antes de ativar a API REST do Slurm, verifique se você tem:
+ **Versão do cluster**: Slurm versão 25.05 ou superior.
+ **Grupo de segurança**: regras que permitem o tráfego HTTP na porta 6820 a partir das fontes desejadas.

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

**Para habilitar a API REST do Slurm em um novo cluster**

------
#### [ Console de gerenciamento da AWS ]

1. Abra o console AWS PCS em [https://console.aws.amazon.com/pcs/](https://console.aws.amazon.com/pcs/).

1. Selecione **Criar cluster**.

1. Em **Detalhes do cluster**, escolha Slurm versão 25.05 ou superior.

1. Defina as outras configurações do cluster conforme necessário.

1. Na seção **Configuração do Agendador**, defina a **API REST** como **Ativada**.

1. Configure seu grupo de segurança de cluster para permitir tráfego HTTP na porta 6820 a partir das fontes desejadas.

1. Conclua o processo de criação do cluster.

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

1. Adicione uma configuração REST do Slurm ao criar seu 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. Configure seu grupo de segurança de cluster para permitir tráfego HTTP na porta 6820 a partir das fontes desejadas.

------

**Para habilitar a API REST do Slurm em um cluster existente**

------
#### [ Console de gerenciamento da AWS ]

1. Abra o console AWS PCS em [https://console.aws.amazon.com/pcs/](https://console.aws.amazon.com/pcs/).

1. Escolha seu cluster na lista.

1. Verifique se seu cluster usa a versão 25.05 ou superior do Slurm nos detalhes do cluster.

1. Escolha **Editar cluster**.

1. Na seção **Configuração do Agendador**, defina a **API REST** como **Ativada**.

1. Escolha **Atualizar cluster** para aplicar as alterações.

1. Configure seu grupo de segurança de cluster para permitir tráfego HTTP na porta 6820 a partir das fontes desejadas.

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

1. Atualize seu cluster com uma configuração REST do Slurm, como neste exemplo.

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

1. Configure seu grupo de segurança de cluster para permitir tráfego HTTP na porta 6820 a partir das fontes desejadas.

------

## O que acontece depois de ativar
<a name="slurm-rest-api-enable-results"></a>

Quando você ativa a API REST, o AWS PCS automaticamente:
+ Gera uma chave de assinatura do JWT e a armazena no AWS Secrets Manager.
+ Expõe o endpoint da API `https://<clusterPrivateIpAddress>:6820` em sua VPC.
+ Atualiza a configuração do cluster para mostrar os detalhes do endpoint da API REST.

Agora você pode autenticar e usar a API REST para gerenciamento de tarefas e operações de cluster.