As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# `pcluster list-clusters`
<a name="pcluster.list-clusters-v3"></a>

Retorna uma lista de clusters existentes.

```
pcluster list-clusters [-h]
                [--cluster-status {CREATE_IN_PROGRESS,CREATE_FAILED,CREATE_COMPLETE,
                           DELETE_IN_PROGRESS,DELETE_FAILED,UPDATE_IN_PROGRESS,
                           UPDATE_COMPLETE,UPDATE_FAILED}
                           [{CREATE_IN_PROGRESS,CREATE_FAILED,CREATE_COMPLETE,
                             DELETE_IN_PROGRESS,DELETE_FAILED,UPDATE_IN_PROGRESS,
                             UPDATE_COMPLETE,UPDATE_FAILED} ...]]
                [--debug]
                [--next-token NEXT_TOKEN]
                [--query QUERY]
                [--region REGION]
```

## Argumentos nomeados
<a name="pcluster-v3.list-clusters.namedargs"></a>

**-h, --help**  
Mostra o texto de ajuda para `pcluster list-clusters`.

**--cluster-status \$1`CREATE_IN_PROGRESS`, `CREATE_FAILED`, `CREATE_COMPLETE`, `DELETE_IN_PROGRESS`, `DELETE_FAILED`, `UPDATE_IN_PROGRESS`, `UPDATE_COMPLETE`, `UPDATE_FAILED`\$1 [\$1`CREATE_IN_PROGRESS`, `CREATE_FAILED`, `CREATE_COMPLETE`, `DELETE_IN_PROGRESS`, `DELETE_FAILED`, `UPDATE_IN_PROGRESS`, `UPDATE_COMPLETE`, `UPDATE_FAILED`\$1 ...]**  
Especifica a lista de status de cluster a serem filtrados. (Padronizado como `all`.)

**--debug**  
Habilita o log de depuração.

**--next-token *NEXT\$1TOKEN***  
O token para o próximo conjunto de resultados.

**--query *QUERY***  
Especifica a JMESPath consulta a ser executada na saída.

**--region, -r *REGION***  
Especifica o a Região da AWS ser usado. O Região da AWS deve ser especificado usando a variável de `AWS_DEFAULT_REGION` ambiente, a `region` configuração na `[default]` seção do `~/.aws/config` arquivo ou o `--region` parâmetro.

**Exemplo usando a AWS ParallelCluster versão 3.1.4:**

```
$ pcluster list-clusters
{
  "clusters": [
    {
      "clusterName": "cluster-v3",
      "cloudformationStackStatus": "CREATE_COMPLETE",
      "cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
      "region": "us-east-1",
      "version": "3.1.4",
      "clusterStatus": "CREATE_COMPLETE"
    }
  ]
}
```