本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# AWS ParallelCluster Python 程式庫 API
<a name="pc-py-library-v3"></a>

從 3.5.0 AWS ParallelCluster 版開始，您可以使用 AWS ParallelCluster Python AWS ParallelCluster 程式庫存取 。您可以在`pcluster`環境中或在 AWS Lambda 執行時間內存取程式 AWS ParallelCluster 庫。了解如何使用 AWS ParallelCluster Python AWS ParallelCluster 程式庫存取 API。 AWS ParallelCluster Python 程式庫提供與 AWS ParallelCluster API 相同的功能。

 AWS ParallelCluster Python 程式庫操作和參數會在轉換為`snake_case`不含大寫字母的 API 參數時鏡像這些參數。

**Topics**
+ [AWS ParallelCluster Python 程式庫授權](#pc-py-lib-auth)
+ [安裝 AWS ParallelCluster Python 程式庫](#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 適用於 AWS ParallelCluster Python 程式庫](#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)。

## 安裝 AWS ParallelCluster Python 程式庫
<a name="pc-py-lib-install"></a>

1. 遵循 中的指示安裝 `pcluster` CLI 3.5.0 版或更新版本。 [設定 AWS ParallelCluster](install-v3.md)

1. 匯入`pcluster`模組並開始使用程式庫，如下列範例所示：

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

## AWS Lambda 適用於 AWS ParallelCluster Python 程式庫
<a name="lambda-py-v3"></a>

您可以部署 Lambda 層和執行時間來存取 AWS ParallelCluster Python 程式庫。我們會託管 zip AWS ParallelCluster 檔案，您可以輸入 zip 檔案的連結，如下列步驟所述。Lambda 使用 zip 檔案來準備執行期環境，以支援對 Python 程式庫的存取。 AWS ParallelCluster Python 程式庫以 3.5.0 AWS ParallelCluster 版新增。您只能將 程式庫用於 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 版本。)

### 開始使用 存取 AWS ParallelCluster Python 程式庫 AWS Lambda
<a name="lambda-py-get-started-v3"></a>

**建立 Lambda 層**

1. 登入 AWS 管理主控台 並導覽至 AWS Lambda 主控台。

1. 在導覽窗格中，選取**圖層**，然後選取**建立圖層**。

1. 輸入 layer 的名稱，然後選取**從 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. 針對**執行時間**，選擇 **Python 3.12 **執行時間。

1. 針對**架構**，選擇 **x86\_64** 架構。

1. 選擇**建立函數**。

1. 建立函數之後，請選擇**圖層**，然後選取**新增圖層**。

1. 選取**自訂圖**層，然後選擇您在先前步驟中建立的圖層。

1. 選擇 layer 版本。

1. 選擇**新增**。

1. 您的 Lambda 需要許可才能管理使用 建立的叢集 AWS ParallelCluster。使用 中列出的許可建立 Lambda 角色[基本 AWS ParallelCluster `pcluster`使用者政策](iam-roles-in-parallelcluster-v3.md#iam-roles-in-parallelcluster-v3-base-user-policy)。

您現在可以 AWS ParallelCluster 從 Python 程式庫存取 ，如中所述[AWS ParallelCluster Python 程式庫 API](#pc-py-library-v3)。