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

# listImages
<a name="list-images"></a>

기존 사용자 지정 이미지 목록을 검색합니다.

**Topics**
+ [요청 구문](#list-images-request)
+ [요청 본문](#list-images-request-body)
+ [응답 구문](#list-images-response)
+ [응답 본문](#list-images-response-body)
+ [예제](#list-images-example)

## 요청 구문
<a name="list-images-request"></a>

```
GET /images/custom
{
  "imageStatus": "string",
  "nextToken": "string",
  "region": "string"
}
```

## 요청 본문
<a name="list-images-request-body"></a>

**imageStatus**  
제공된 상태별로 이미지를 필터링합니다.  
유형: string  
유효값: `AVAILABLE | PENDING | FAILED`  
필수 항목 여부: 예

**nextToken**  
다음 결과 집합에 대한 토큰입니다.  
유형: string  
필수 항목 여부: 아니요

**region**  
해당 이미지가 AWS 리전 있는 입니다.  
유형: string  
필수사항: 아니요

## 응답 구문
<a name="list-images-response"></a>

```
{
  "nextToken": "string",
  "images": [
    {
      "imageId": "string",
      "ec2AmiInfo": {
        "amiId": "string"
      },
      "region": "string",
      "version": "string",
      "cloudformationStackArn": "string",
      "imageBuildStatus": "BUILD_IN_PROGRESS",
      "cloudformationStackStatus": "CREATE_IN_PROGRESS"
    }
  ]
}
```

## 응답 본문
<a name="list-images-response-body"></a>

**images**  
이미지의 목록입니다.    
**cloudformationStackArn**  
메인 CloudFormation 스택의 Amazon 리소스 이름(ARN)입니다.  
유형: string  
**cloudformationStackStatus**  
CloudFormation 스택 상태입니다.  
유형: string  
유효값: `CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | ROLLBACK_IN_PROGRESS | ROLLBACK_FAILED | ROLLBACK_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_ROLLBACK_IN_PROGRESS | UPDATE_ROLLBACK_FAILED | UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_ROLLBACK_COMPLETE`  
**ec2AmiInfo**    
**ami\$1id**  
Amazon EC2 AMI ID.  
유형: string  
**imageBuildStatus**  
이미지 빌드 상태입니다.  
유효값: `BUILD_IN_PROGRESS | BUILD_FAILED | BUILD_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE`  
유형: string  
**imageId**  
이미지의 ID입니다.  
유형: string  
**리전**  
이미지가 생성되는 AWS 리전 입니다.  
유형: string  
**version**  
이미지를 빌드하는 데 사용되는 AWS ParallelCluster 버전입니다.  
유형: string

**nextToken**  
다음 결과 집합을 가져오기 위해 사용할 수 있는 토큰이지만 결과가 더 이상 없는 경우에는 `null`입니다.  
유형: string

## 예제
<a name="list-images-example"></a>

------
#### [ Python ]

**요청**

```
$ list_images("AVAILABLE")
```

**200 응답**

```
{
  'images': [
    {
      'ec2_ami_info': {
        'ami_id': 'ami-abcdef01234567890'
      },
      'image_build_status': 'BUILD_COMPLETE',
      'image_id': 'custom-image',
      'region': 'us-east-1',
      'version': '3.2.1'
    }
  ]
}
```

------