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á.

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

AWS O PCS fornece suporte gerenciado para a API REST nativa do Slurm`slurmrestd`, fornecendo uma interface HTTP para interação programática com clusters. Você pode enviar trabalhos, monitorar o status do cluster e gerenciar recursos por meio de solicitações HTTP padrão sem precisar de acesso direto ao shell ao seu cluster.

## Casos de uso comuns
<a name="slurm-rest-api-use-cases"></a>

A API REST do Slurm oferece suporte a vários cenários de integração:
+ **Integração de aplicativos da Web**: crie front-ends e aplicativos da web personalizados que enviam e gerenciam trabalhos diretamente.
+ **Integração com o Jupyter Notebook**: permite que os pesquisadores enviem trabalhos de ambientes de notebook sem sair do fluxo de trabalho de desenvolvimento.
+ **Integração de soluções de parceiros**: conecte ferramentas de HPC e gerenciadores de fluxo de trabalho de terceiros aos seus clusters de AWS PCS.
+ **Gerenciamento programático de clusters**: automatize os fluxos de trabalho de envio, monitoramento e gerenciamento de recursos de tarefas.
+ **Fluxos de trabalho de computação de pesquisa**: Support ambientes de pesquisa acadêmica e empresarial que exigem gerenciamento de tarefas. API-driven 

## Requisitos e limitações
<a name="slurm-rest-api-requirements"></a>

Antes de usar a API REST do Slurm, revise estes detalhes:
+ Seu cluster deve usar a versão 25.05 ou superior do Slurm.
+ O endpoint da API só poderá ser acessado por meio de um endereço IP privado na VPC do seu cluster.
+ Seu grupo de segurança do cluster deve permitir tráfego HTTP na porta 6820.
+ A autenticação requer tokens JWT com declarações de identidade de usuário específicas.

As limitações atuais incluem:
+ Os tokens gerados por não `scontrol token` são suportados.
+ `X-SLURM-USER-NAME`a representação do cabeçalho não está disponível.
+ Algumas funcionalidades exigem que a contabilidade do Slurm esteja ativada.
+ Não é compatível com o mecanismo do plug-in de filtro CLI do Slurm.
+ As conexões com o endpoint da API REST não são criptografadas com TLS.

**Topics**
+ [Casos de uso comuns](#slurm-rest-api-use-cases)
+ [Requisitos e limitações](#slurm-rest-api-requirements)
+ [Habilitando a API REST do Slurm no PCS AWS](slurm-rest-api-enable.md)
+ [Autenticação com a API REST do Slurm no PCS AWS](slurm-rest-api-authenticate.md)
+ [Usando a API REST do Slurm para gerenciamento de tarefas no PCS AWS](slurm-rest-api-use.md)
+ [Perguntas frequentes sobre a API REST do Slurm no PCS AWS](slurm-rest-api-faq.md)