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à.

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

Descrivi le istanze che appartengono a un cluster.

**Topics**
+ [Sintassi della richiesta](#describe-cluster-instances-request)
+ [Corpo della 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 della richiesta
<a name="describe-cluster-instances-request-body"></a>

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

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

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

**Nome coda**  
Filtra le istanze in base al nome della coda.  
Tipo: stringa  
Obbligatorio: no

**region**  
Il luogo in Regione AWS cui si trova il cluster.  
Tipo: stringa  
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'istanza Amazon EC2.  
Tipo: stringa  
**instanceType**  
Il tipo di istanza Amazon EC2.  
Tipo: stringa  
**launchTime**  
L'ora in cui è stata avviata l'istanza Amazon EC2.  
Tipo: datetime  
**Tipo di nodo**  
Il tipo di nodo.  
Tipo: stringa  
Valori validi: `HeadNode`, `ComputeNode`, `LoginNode`  
**pubblico IpAddress**  
L'indirizzo IP pubblico del cluster.  
Tipo: stringa  
**Nome della coda**  
Il nome della coda in cui l'istanza Amazon EC2 esegue il backup di un nodo.  
Tipo: stringa  
**stato**  
Lo stato dell'istanza Amazon EC2 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}})
```

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

------