기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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