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 create-cluster`
<a name="pcluster.create-cluster-v3"></a>

Cria um AWS ParallelCluster cluster.

```
pcluster create-cluster [-h]
                 --cluster-configuration {{CLUSTER_CONFIGURATION}}
                 --cluster-name {{CLUSTER_NAME}}
                [--debug]
                [--dryrun {{DRYRUN}}]   
                [--query {{QUERY}}]
                [--region {{REGION}}]
                [--rollback-on-failure {{ROLLBACK_ON_FAILURE}}]
                [--suppress-validators {{SUPPRESS_VALIDATORS}} [{{SUPPRESS_VALIDATORS}} ...]]                        
                [--validation-failure-level {INFO,WARNING,ERROR}]
```

## Argumentos nomeados
<a name="pcluster-v3.create-cluster.namedargs"></a>

**-h, --help**  
Mostra o texto de ajuda para `pcluster create-cluster`.

**--cluster-configuration, -c {{CLUSTER\_CONFIGURATION}}**  
Especifica o arquivo de configuração do cluster YAML.

**--cluster-name, -n {{CLUSTER\_NAME}}**  
O nome do novo cluster a ser criado.  
O nome deve iniciar com um caractere alfabético. O nome do pode ter até 60 caracteres. Se a contabilidade do Slurm estiver ativada, o nome poderá ter até 40 caracteres.  
Caracteres válidos: a-z, A-Z, 0-9 e - (hífen).

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

**--dryrun {{DRYRUN}}**  
Quando `true`, o comando executa a validação sem criar recursos. Você pode usar isso para validar a configuração do cluster. (Padronizado como `false`.)

**--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 [`Region`](cluster-configuration-file-v3.md#yaml-Region)configuração no arquivo de configuração do cluster, 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.

**--rollback-on-failure {{ROLLBACK\_ON\_FAILURE}}**  
Se definido como `true`, inicia automaticamente uma reversão da pilha de cluster em caso de falhas. (Padronizado como `true`.)

**--suppress-validators {{SUPPRESS\_VALIDATORS}} [{{SUPPRESS\_VALIDATORS}} ...]**  
Identifica um ou mais validadores de configuração a serem suprimidos.  
 Formato: (`ALL`\|typo:`[A-Za-z0-9]+`)

**--validation-failure-level {`INFO`,`WARNING`,`ERROR`}**  
O nível mínimo de validação que faz com que a criação de imagem falhe. (Padronizado como `ERROR`.)

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

```
$ pcluster create-cluster -c {{cluster-config.yaml}} -n {{cluster-v3}}
{
  "cluster": {
    "clusterName": "cluster-v3",
    "cloudformationStackStatus": "CREATE_IN_PROGRESS",
    "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_IN_PROGRESS"
  }
}
```