

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# AWS ParallelCluster API de bibliothèque Python
<a name="pc-py-library-v3"></a>

À partir de AWS ParallelCluster la version 3.5.0, vous pouvez y accéder AWS ParallelCluster avec la bibliothèque AWS ParallelCluster Python. Vous pouvez accéder à la AWS ParallelCluster bibliothèque dans votre `pcluster` environnement ou depuis un environnement AWS Lambda d'exécution. Découvrez comment accéder à l' AWS ParallelCluster API à l'aide de la bibliothèque AWS ParallelCluster Python. La bibliothèque AWS ParallelCluster Python offre les mêmes fonctionnalités que celles fournies par l' AWS ParallelCluster API.

Les opérations et les paramètres de la bibliothèque AWS ParallelCluster Python reflètent ceux des paramètres de l'API lorsqu'ils sont convertis `snake_case` sans majuscules.

**Topics**
+ [AWS ParallelCluster Autorisation de bibliothèque Python](#pc-py-lib-auth)
+ [Installation de la bibliothèque AWS ParallelCluster Python](#pc-py-lib-install)
+ [Opérations de l'API du cluster](pc-py-lib-api-cluster.md)
+ [Opérations de l'API du parc de calcul](pc-py-lib-api-fleet.md)
+ [Opérations de journalisation des clusters et des piles](pc-py-lib-api-logs-cluster-stack.md)
+ [Opérations de l'API Image](pc-py-lib-api-image.md)
+ [Opérations de journalisation des images et des piles](pc-py-lib-api-logs-image-stack.md)
+ [Exemple](pc-py-lib-api-examples.md)
+ [AWS Lambda pour la bibliothèque AWS ParallelCluster Python](#lambda-py-v3)

## AWS ParallelCluster Autorisation de bibliothèque Python
<a name="pc-py-lib-auth"></a>

Spécifiez les informations d'identification en utilisant l'une des méthodes standard valides pour boto3. Pour plus d'informations, consultez la documentation de [boto3](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#configuration).

## Installation de la bibliothèque AWS ParallelCluster Python
<a name="pc-py-lib-install"></a>

1. Installez la version 3.5.0 ou ultérieure de la `pcluster` CLI en suivant les instructions données dans[Con AWS ParallelCluster figuration](install-v3.md).

1. Importez le `pcluster` module et commencez à utiliser la bibliothèque, comme indiqué dans l'exemple suivant :

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

## AWS Lambda pour la bibliothèque AWS ParallelCluster Python
<a name="lambda-py-v3"></a>

Vous pouvez déployer une couche Lambda et un environnement d'exécution pour accéder à la bibliothèque AWS ParallelCluster Python. Nous hébergeons des fichiers AWS ParallelCluster zip que vous pouvez utiliser en saisissant le lien vers le fichier zip comme décrit dans les étapes suivantes. Lambda utilise les fichiers zip pour préparer l'environnement d'exécution afin de prendre en charge l'accès à la bibliothèque Python. La bibliothèque AWS ParallelCluster Python a été ajoutée avec AWS ParallelCluster la version 3.5.0. Vous ne pouvez utiliser la bibliothèque que pour les versions 3.5.0 et ultérieures.

L'URL du fichier zip hébergé est au format :`s3://aws-region-id-aws-parallelcluster/parallelcluster/3.15.0/layers/aws-parallelcluster/lambda-layer.zip`. (Remplacez *3.15.0* par la AWS ParallelCluster version que vous souhaitez utiliser à l'étape suivante.)

### Commencez à accéder à la bibliothèque AWS ParallelCluster Python avec AWS Lambda
<a name="lambda-py-get-started-v3"></a>

**Création d'une couche Lambda**

1. Connectez-vous à la AWS Lambda console AWS Management Console et naviguez jusqu'à celle-ci.

1. Dans le volet de navigation, sélectionnez **Layers**, puis **Create layer**.

1. Entrez un nom pour votre couche et sélectionnez **Upload a file from Amazon S3**.

1. Entrez l'URL du fichier zip : s3 ://*aws-region-id**3.15.0*-aws-parallelcluster/parallelcluster//-layer.zip. layers/aws-parallelcluster/lambda

1. Pour les **architectures compatibles**, choisissez l'architecture **x86\$164**.

1. Pour les **environnements d'exécution compatibles**, choisissez le moteur d'exécution **Python 3.12**.

1. Choisissez **Créer**.

**Utilisez votre couche Lambda**

1. Dans le volet de navigation de la console Lambda, sélectionnez **Functions**, puis **Create** function.

1. Entrez un nom pour votre fonction.

1. Pour **Runtime**, choisissez le runtime **Python 3.12**.

1. Pour **Architecture**, choisissez l'architecture **x86\$164**.

1. Choisissez **Créer une fonction**.

1. Une fois la fonction créée, choisissez **Layers**, puis sélectionnez **Ajouter une couche**.

1. Sélectionnez **Couches personnalisées** et choisissez la couche que vous avez créée lors des étapes précédentes.

1. Choisissez la version de la couche.

1. Choisissez **Ajouter**.

1. Votre Lambda a besoin d'autorisations pour gérer les clusters créés avec. AWS ParallelCluster Créez un rôle Lambda avec les autorisations répertoriées dans. [Politique AWS ParallelCluster `pcluster` utilisateur de base](iam-roles-in-parallelcluster-v3.md#iam-roles-in-parallelcluster-v3-base-user-policy)

Vous pouvez désormais y accéder AWS ParallelCluster depuis la bibliothèque Python, comme décrit dans[AWS ParallelCluster API de bibliothèque Python](#pc-py-library-v3).