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

# AWS ParallelCluster API da biblioteca Python
<a name="pc-py-library-v3"></a>

A partir da AWS ParallelCluster versão 3.5.0, você pode acessar AWS ParallelCluster com a biblioteca AWS ParallelCluster Python. Você pode acessar a AWS ParallelCluster biblioteca em seu `pcluster` ambiente ou de dentro de um AWS Lambda tempo de execução. Saiba como acessar a AWS ParallelCluster API usando a biblioteca AWS ParallelCluster Python. A biblioteca AWS ParallelCluster Python oferece a mesma funcionalidade que a AWS ParallelCluster API oferece.

As operações e os parâmetros da biblioteca AWS ParallelCluster Python refletem os parâmetros da API quando convertidos em `snake_case` sem letras maiúsculas.

**Topics**
+ [AWS ParallelCluster Autorização da biblioteca Python](#pc-py-lib-auth)
+ [Instale a AWS ParallelCluster biblioteca Python](#pc-py-lib-install)
+ [Operações de API do cluster](pc-py-lib-api-cluster.md)
+ [Operações da API da frota de computação](pc-py-lib-api-fleet.md)
+ [Operações de cluster e log de pilha](pc-py-lib-api-logs-cluster-stack.md)
+ [Operações da API Image](pc-py-lib-api-image.md)
+ [Operações de log de imagens e pilhas](pc-py-lib-api-logs-image-stack.md)
+ [Exemplo](pc-py-lib-api-examples.md)
+ [AWS Lambda para a biblioteca AWS ParallelCluster Python](#lambda-py-v3)

## AWS ParallelCluster Autorização da biblioteca Python
<a name="pc-py-lib-auth"></a>

Especifique as credenciais usando qualquer uma das formas padrão válidas para boto3. Para obter mais informações, consulte a [documentação do boto3](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#configuration).

## Instale a AWS ParallelCluster biblioteca Python
<a name="pc-py-lib-install"></a>

1. Instale a CLI `pcluster` versão 3.5.0 ou posterior seguindo as instruções fornecidas em [Configurar AWS ParallelCluster](install-v3.md).

1. Importe o módulo `pcluster` e comece a usar a biblioteca, conforme mostrado no exemplo a seguir:

   ```
   import pcluster.lib as {{pc}}
   pc.create_cluster(cluster_name={{"mycluster"}}, cluster_configuration={{"config.yaml"}}
   ```

## AWS Lambda para a biblioteca AWS ParallelCluster Python
<a name="lambda-py-v3"></a>

Você pode implantar uma camada Lambda e um tempo de execução para acessar a biblioteca Python AWS ParallelCluster . Hospedamos arquivos AWS ParallelCluster zip que você pode usar inserindo o link para o arquivo zip conforme descrito nas etapas a seguir. O Lambda usa os arquivos zip para preparar o ambiente de runtime para dar suporte ao acesso à biblioteca Python. A biblioteca AWS ParallelCluster Python foi adicionada com a AWS ParallelCluster versão 3.5.0. Você só pode usar a biblioteca para versões 3.5.0 e posteriores.

O URL do arquivo zip hospedado está no formato:`s3://{{aws-region-id}}-aws-parallelcluster/parallelcluster/{{3.15.0}}/layers/aws-parallelcluster/lambda-layer.zip`. ({{3.15.0}}Substitua pela AWS ParallelCluster versão que você deseja usar na etapa a seguir.)

### Comece a acessar a biblioteca AWS ParallelCluster Python com AWS Lambda
<a name="lambda-py-get-started-v3"></a>

**Crie uma camada do Lambda**

1. Faça login no Console de gerenciamento da AWS e navegue até o AWS Lambda console.

1. No painel de navegação, escolha **Camadas** e **Criar uma camada**.

1. Insira um nome para sua camada e selecione **Fazer upload de um arquivo do Amazon S3**.

1. Insira o URL do arquivo zip: s3://{{aws-region-id}}{{3.15.0}}-aws-parallelcluster/parallelcluster//-layer.zip. layers/aws-parallelcluster/lambda

1. Para **Arquiteturas compatíveis**, escolha a arquitetura **x86\_64**.

1. Para **tempos de execução compatíveis**, escolha o tempo de execução do **Python 3.12**.

1. Escolha **Criar**.

**Use sua camada do Lambda**

1. No painel de navegação do console Lambda, selecione **Funções** e, em seguida, **Criar função**.

1. Insira um nome para sua função.

1. Em **Tempo de execução**, escolha o tempo de execução do **Python 3.12**.

1. Em **Arquitetura**, escolha a arquitetura **x86\_64**.

1. Escolha a opção **Criar função**.

1. Depois que a função for criada, escolha **Camadas** e selecione **Adicionar uma camada**.

1. Selecione **Camadas personalizadas** e escolha a camada que você criou nas etapas anteriores.

1. Escolha a versão da camada.

1. Escolha **Adicionar**.

1. Seu Lambda precisa de permissões para gerenciar clusters criados com o. AWS ParallelCluster Crie uma função do Lambda com as permissões listadas em [Política básica de usuário `pcluster` do AWS ParallelCluster](iam-roles-in-parallelcluster-v3.md#iam-roles-in-parallelcluster-v3-base-user-policy).

Agora você pode acessar a AWS ParallelCluster partir da biblioteca Python, conforme descrito em. [AWS ParallelCluster API da biblioteca Python](#pc-py-library-v3)