

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Descrivi le istanze che appartengono a un cluster.

**Topics**
+ [Sintassi della richiesta](#describe-cluster-instances-request)
+ [Corpo di richiesta](#describe-cluster-instances-request-body)
+ [Sintassi della risposta](#describe-cluster-instances-response)
+ [Corpo di risposta](#describe-cluster-instances-response-body)
+ [Esempio](#describe-cluster-instances-example)

## Sintassi della richiesta
<a name="describe-cluster-instances-request"></a>

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

## Corpo di richiesta
<a name="describe-cluster-instances-request-body"></a>

**ClusterName**  
Il nome del cluster.  
Tipo: stringa  
Campo obbligatorio: sì

**nextToken**  
Token per il set di risultati successivo.  
Tipo: stringa  
Campo obbligatorio: no

**Tipo di nodo**  
Filtra le istanze per tipo di nodo.  
Tipo: stringa  
Valori validi: `HeadNode`, `ComputeNode`, `LoginNode`  
Campo obbligatorio: no

**QueueName**  
Filtra le istanze per nome della coda.  
Tipo: stringa  
Campo obbligatorio: no

**Regione**  
 Regione AWS Quello in cui si trova il cluster.  
Tipo: stringa  
Campo obbligatorio: no

## Sintassi della risposta
<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"
    }
  ]
}
```

## Corpo di risposta
<a name="describe-cluster-instances-response-body"></a>

**Istanze**  
L'elenco delle istanze del cluster.    
**instanceId**  
L'ID dell' EC2 istanza Amazon.  
Tipo: stringa  
**instanceType**  
Il tipo di EC2 istanza Amazon.  
Tipo: stringa  
**launchTime**  
L'ora in cui è stata lanciata l' EC2 istanza Amazon.  
Tipo: datetime  
**Tipo di nodo**  
Il tipo di nodo.  
Tipo: stringa  
Valori validi: `HeadNode`, `ComputeNode`, `LoginNode`  
**publicIpAddress**  
L'indirizzo IP pubblico del cluster.  
Tipo: stringa  
**QueueName**  
Il nome della coda in cui l' EC2 istanza Amazon esegue il backup di un nodo.  
Tipo: stringa  
**stato**  
Lo stato dell' EC2 istanza Amazon del nodo.  
Tipo: stringa  
Valori validi: `pending | running | shutting-down | terminated | stopping | stopped`

**nextToken**  
Token che è possibile usare per recuperare il set di risultati successivo oppure `null` se non ci sono risultati aggiuntivi.  
Tipo: stringa

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

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

**Richiesta**

```
$ describe_cluster_instances({{cluster_name_3x}})
```

**200 Risposta**

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

------