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

# `pcluster list-official-images`
<a name="pcluster.list-official-images-v3"></a>

描述 AWS ParallelCluster AMIs。

```
pcluster list-official-images [-h]
                [--architecture {{ARCHITECTURE}}]
                [--debug]
                [--os {{OS}}]
                [--query {{QUERY}}]
                [--region {{REGION}}]
```

## 具名引數
<a name="pcluster-v3.list-official-images.namedargs"></a>

**-h, --help**  
顯示 的說明文字`pcluster list-official-images`。

**--architecture {{ARCHITECTURE}}**  
指定用於篩選結果的架構。如果未指定此參數，則會傳回所有架構。

**--debug**  
啟用偵錯記錄。

**--os {{OS}}**  
指定用於篩選結果的作業系統。如果未指定此參數，則會傳回所有作業系統。

**--query {{QUERY}}**  
指定要在輸出上執行的 JMESPath 查詢。

**--region, -r {{REGION}}**  
指定 AWS 區域 要使用的 。 AWS 區域 必須使用映像組態檔案中[的區域](image-builder-configuration-file-v3.md#yaml-build-image-Region)設定、`AWS_DEFAULT_REGION`環境變數、 `~/.aws/config` 檔案 `[default]`區段中的`region`設定或 `--region` 參數來指定 。

**使用 3.1.2 AWS ParallelCluster 版的範例：**

```
$ pcluster list-official-images
{
  "images": [
    {
      "amiId": "ami-015cfeb4e0d6306b2",
      "os": "ubuntu2204",
      "name": "aws-parallelcluster-3.1.2-ubuntu-2204-lts-hvm-x86_64-202202261505 2022-02-26T15-08-34.759Z",
      "version": "3.1.2",
      "architecture": "x86_64"
    },
    {
      "amiId": "ami-036f23237ce49d25b",
      "os": "ubuntu2204",
      "name": "aws-parallelcluster-3.1.2-ubuntu-1804-lts-hvm-x86_64-202202261505 2022-02-26T15-08-17.558Z",
      "version": "3.1.2",
      "architecture": "x86_64"
    },
    {
      "amiId": "ami-09e5327e694d89ef4",
      "os": "ubuntu2204",
      "name": "aws-parallelcluster-3.1.2-ubuntu-2204-lts-hvm-arm64-202202261505 2022-02-26T15-08-45.736Z",
      "version": "3.1.2",
      "architecture": "arm64"
    },
    {
      "amiId": "ami-0b9b0874c35f626ae",
      "os": "alinux2",
      "name": "aws-parallelcluster-3.1.2-amzn2-hvm-x86_64-202202261505 2022-02-26T15-08-31.311Z",
      "version": "3.1.2",
      "architecture": "x86_64"
    },
    {
      "amiId": "ami-0d0de4f95f56374bc",
      "os": "alinux2",
      "name": "aws-parallelcluster-3.1.2-amzn2-hvm-arm64-202202261505 2022-02-26T15-08-46.088Z",
      "version": "3.1.2",
      "architecture": "arm64"
    },
    {
      "amiId": "ami-0ebf7bc54b8740dc6",
      "os": "ubuntu2204",
      "name": "aws-parallelcluster-3.1.2-ubuntu-1804-lts-hvm-arm64-202202261505 2022-02-26T15-08-45.293Z",
      "version": "3.1.2",
      "architecture": "arm64"
    }
  ]
}
```