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

# describeClusterInstances
<a name="describe-cluster-instances"></a>

클러스터에 속하는 인스턴스를 설명합니다.

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

## 요청 구문
<a name="describe-cluster-instances-request"></a>

```
GET /v3/clusters/{clusterName}/instances
{
  "nextToken": "string",
  "nodeType": "string",
  "queueName": "string",
  "region": "string"
}
```

## 요청 본문
<a name="describe-cluster-instances-request-body"></a>

**clusterName**  
클러스터의 이름입니다.  
유형: string  
필수 항목 여부: 예

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

**nodeType**  
노드 유형별로 인스턴스를 필터링합니다.  
유형: string  
유효한 값: `HeadNode`, `ComputeNode`, `LoginNode`   
필수 여부: 아니요

**queueName**  
대기열 이름을 기준으로 인스턴스를 필터링합니다.  
유형: string  
필수 항목 여부: 아니요

**region**  
클러스터가 AWS 리전 있는 입니다.  
유형: string  
필수사항: 아니요

## 응답 구문
<a name="describe-cluster-instances-response"></a>

```
{
  "nextToken": "string",
  "instances": [
    {
      "instanceId": "string",
      "instanceType": "string",
      "launchTime": "2019-08-24T14:15:22Z",
      "privateIpAddress": "string",
      "publicIpAddress": "string",
      "state": "pending",
      "nodeType": "HeadNode",
      "queueName": "string",
      "poolName": "string"
    }
  ]
}
```

## 응답 본문
<a name="describe-cluster-instances-response-body"></a>

**instances**  
클러스터 인스턴스 목록입니다입니다.    
**instanceId**  
Amazon EC2 인스턴스 ID입니다.  
유형: string  
**instanceType**  
Amazon EC2 인스턴스 유형  
유형: string  
**launchTime**  
Amazon EC2 인스턴스가 시작된 시간입니다.  
유형: 날짜/시간  
**nodeType**  
노드 유형입니다.  
유형: string  
유효한 값: `HeadNode`, `ComputeNode`, `LoginNode`   
**publicIpAddress**  
클러스터 퍼블릭 IP 주소입니다.  
유형: string  
**queueName**  
Amazon EC2 인스턴스가 노드를 지원하는 대기열의 이름입니다.  
유형: string  
**state**  
노드 Amazon EC2 인스턴스 상태입니다.  
유형: string  
유효값: `pending | running | shutting-down | terminated | stopping | stopped`

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

## 예제
<a name="describe-cluster-instances-example"></a>

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

**요청**

```
$ describe_cluster_instances(cluster_name_3x)
```

**200 응답**

```
{
  "instances": [
    {
      "instance_id": "i-abcdef01234567890",
      "instance_type": "t2.micro",
      "launch_time": datetime.datetime(2022, 3, 30, 14, 2, 7, tzinfo=tzlocal()),
      "node_type": "HeadNode",
      "private_ip_address": "192.0.2.5",
      "public_ip_address": "198.51.100.180",
      "state": "running"
    }
  ]
}
```

------