翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS ParallelCluster Python ライブラリ API
<a name="pc-py-library-v3"></a>

 AWS ParallelCluster バージョン 3.5.0 以降では、Python AWS ParallelCluster ライブラリ AWS ParallelCluster を使用して にアクセスできます。`pcluster` 環境内または AWS Lambda ランタイム内から AWS ParallelCluster ライブラリにアクセスできます。Python ライブラリを使用して API AWS ParallelCluster にアクセスする AWS ParallelCluster 方法について説明します。Python ライブラリは、 AWS ParallelCluster API AWS ParallelCluster が提供するのと同じ機能を提供します。

 AWS ParallelCluster Python ライブラリのオペレーションとパラメータは、大文字なしで に変換すると、API パラメータのオペレーションとパラメータを反映し`snake_case`ます。

**Topics**
+ [AWS ParallelCluster Python ライブラリの認可](#pc-py-lib-auth)
+ [Python AWS ParallelCluster ライブラリをインストールする](#pc-py-lib-install)
+ [クラスター API オペレーション](pc-py-lib-api-cluster.md)
+ [コンピューティングフリートの API オペレーション](pc-py-lib-api-fleet.md)
+ [クラスターとスタックのログ操作](pc-py-lib-api-logs-cluster-stack.md)
+ [イメージの API オペレーション](pc-py-lib-api-image.md)
+ [イメージとスタックのログ操作](pc-py-lib-api-logs-image-stack.md)
+ [例](pc-py-lib-api-examples.md)
+ [AWS Lambda Python AWS ParallelCluster ライブラリ用の](#lambda-py-v3)

## AWS ParallelCluster Python ライブラリの認可
<a name="pc-py-lib-auth"></a>

boto3 で有効な標準的な方法のいずれかを使用して認証情報を指定します。詳細については、「[Boto3 ドキュメント](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#configuration)」を参照してください。

## Python AWS ParallelCluster ライブラリをインストールする
<a name="pc-py-lib-install"></a>

1. [セットアップ AWS ParallelCluster](install-v3.md) に記載されている手順に従って `pcluster` CLI バージョン 3.5.0 以降をインストールします。

1. 次の例に示すように、`pcluster` モジュールをインポートし、ライブラリの使用を開始します。

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

## AWS Lambda Python AWS ParallelCluster ライブラリ用の
<a name="lambda-py-v3"></a>

Lambda レイヤーとランタイムをデプロイして Python AWS ParallelCluster ライブラリにアクセスできます。以下のステップで説明するように、 AWS ParallelCluster zip ファイルへのリンクを入力して使用できる zip ファイルをホストします。Lambda は zip ファイルを使用して Python ライブラリへのアクセスをサポートするランタイム環境を準備します。Python AWS ParallelCluster ライブラリが AWS ParallelCluster バージョン 3.5.0 で追加されました。このライブラリはバージョン 3.5.0 以降でのみ使用できます。

ホストされた zip ファイル URL の形式は です`s3://{{aws-region-id}}-aws-parallelcluster/parallelcluster/{{3.15.0}}/layers/aws-parallelcluster/lambda-layer.zip`。({{3.15.0}} を次のステップで使用する AWS ParallelCluster バージョンに置き換えます）。

### で Python AWS ParallelCluster ライブラリへのアクセスを開始する AWS Lambda
<a name="lambda-py-get-started-v3"></a>

**Lambda レイヤーを作成する**

1. にログイン AWS マネジメントコンソール し、 AWS Lambda コンソールに移動します。

1. ナビゲーションペインで **[レイヤー]** を選択し、**[レイヤーの作成]** を選択します。

1. レイヤーの名前を入力し、**[Amazon S3 からファイルをアップロードする]** を選択します。

1. zip ファイルへの URL を入力します。s3://{{aws-region-id}}-aws-parallelcluster/parallelcluster/{{3.15.0}}/layers/aws-parallelcluster/lambda-layer.zip。

1. **[互換性のあるアーキテクチャ]** で、**[x86\_64]** アーキテクチャを選択します。

1. **互換性のあるランタイムの場合は**、**Python 3.12 **ランタイムを選択します。

1. **[作成]** を選択します。

**Lambda レイヤーを使用する**

1. Lambda コンソールのナビゲーションペインで、**[関数]** を選択し、**[関数の作成]** を選択します。

1. 関数の名前を入力します。

1. **Runtime** で、**Python 3.12 **ランタイムを選択します。

1. **[アーキテクチャ]** で、**[x86\_64]** アーキテクチャを選択します。

1. [**関数の作成**] を選択してください。

1. 関数が作成されたら、**[レイヤー]** を選択し、**[レイヤーの追加]** を選択します。

1. **[カスタムレイヤー]** を選択し、前のステップで作成したレイヤーを選択します。

1. レイヤーバージョンを選択します。

1. **[Add]** (追加) を選択します。

1. Lambda には、 で作成されたクラスターを管理するためのアクセス許可が必要です AWS ParallelCluster。[AWS ParallelCluster `pcluster` 基本ユーザーポリシー](iam-roles-in-parallelcluster-v3.md#iam-roles-in-parallelcluster-v3-base-user-policy) に一覧表示されているアクセス許可を使用して Lambda ロールを作成します。

「」で説明されているように、Python ライブラリ AWS ParallelCluster から にアクセスできるようになりました[AWS ParallelCluster Python ライブラリ API](#pc-py-library-v3)。