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

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

擷取現有自訂映像的清單。

```
pcluster list-images [-h] 
                 --image-status {AVAILABLE,PENDING,FAILED}
                [--debug]
                [--next-token NEXT_TOKEN]
                [--query QUERY]
                [--region REGION]
```

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

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

**--image-status \$1`AVAILABLE`,`PENDING`,`FAILED`\$1**  
依提供的狀態篩選傳回的影像。

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

**--next-token *NEXT\$1TOKEN***  
下一組結果的字符。

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

**--region, -r *REGION***  
指定 AWS 區域 要使用的 。 AWS 區域 必須使用 `AWS_DEFAULT_REGION`環境變數、 `~/.aws/config` 檔案 `[default]`區段中的 `region`設定或 `--region` 參數來指定 。

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

```
$ pcluster list-images --image-status AVAILABLE
{
  "images": [
    {
      "imageId": "custom-alinux2-image",
      "imageBuildStatus": "BUILD_COMPLETE",
      "ec2AmiInfo": {
        "amiId": "ami-1234abcd5678efgh"
      },
      "region": "us-east-1",
      "version": "3.1.2"
    }
  ]
}
```