本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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**  
叢集的名稱。  
類型：字串  
必要：是

**nextToken**  
下一組結果的字符。  
類型：字串  
必要：否

**nodeType**  
依節點類型篩選執行個體。  
類型：字串  
有效值：`HeadNode`、`ComputeNode`、`LoginNode`  
必要：否

**queueName**  
依佇列名稱篩選執行個體。  
類型：字串  
必要：否

**region**  
 AWS 區域 叢集所在的 。  
類型：字串  
必要：否

## 回應語法
<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>

**執行個體**  
叢集執行個體的清單。    
**instanceId**  
Amazon EC2 執行個體 ID。  
類型：字串  
**instanceType**  
Amazon EC2 執行個體類型。  
類型：字串  
**launchTime**  
Amazon EC2 執行個體啟動的時間。  
類型：日期時間  
**nodeType**  
節點類型。  
類型：字串  
有效值：`HeadNode`、`ComputeNode`、`LoginNode`  
**publicIpAddress**  
叢集公有 IP 地址。  
類型：字串  
**queueName**  
Amazon EC2 執行個體正在備份節點的佇列名稱。  
類型：字串  
**state**  
節點 Amazon EC2 執行個體狀態。  
類型：字串  
有效值：`pending | running | shutting-down | terminated | stopping | stopped`

**nextToken**  
可用於擷取下一組結果的字符，或如果沒有其他結果則為 `null`。  
類型：字串

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

------