本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# `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***  
指定 Amazon Web Services 区域 要使用的。 Amazon Web Services 区域 必须使用`AWS_DEFAULT_REGION`环境变量、`~/.aws/config`文件`[default]`部分中的`region`设置或`--region`参数来指定。

**使用 Amazon ParallelCluster 版本 3.1.2 的示例：**

```
$ 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"
    }
  ]
}
```