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

# `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 {`AVAILABLE`,`PENDING`,`FAILED`}**  
指定されたステータスでイメージを返します。

**--debug**  
デバッグログの有効化

**--next-token {{NEXT\_TOKEN}}**  
次の結果セットのトークン。

**--query {{QUERY}}**  
出力に対して実行する JMESPath クエリを指定します。

**--region, -r {{REGION}}**  
 AWS リージョン 使用する を指定します。`AWS_DEFAULT_REGION` 環境変数、 `~/.aws/config` ファイルの `[default]`セクションの `region`設定、または `--region`パラメータを使用して、 を指定 AWS リージョン する必要があります。

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