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

Atualiza um cluster existente para corresponder às configurações de um arquivo de configuração especificado.

**nota**  
 A atualização do cluster será bem-sucedida somente se todos os nós do cluster tiverem aplicado a atualização com êxito. Se a atualização falhar, consulte a [Ver `clusterStatus` é `UPDATE_FAILED` com comando `pcluster describe-cluster`](troubleshooting-fc-v3-update-cluster.md#update-cluster-failure-v3) seção para obter orientações sobre solução de problemas. 

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

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

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

**--cluster-configuration, -c *CLUSTER\$1CONFIGURATION***  
Especifica o arquivo de configuração do cluster YAML.

**--cluster-name, -n *CLUSTER\$1NAME***  
Especifica o nome do cluster.

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

**--dryrun *DRYRUN***  
Quando `true`, executa a validação sem atualizar o cluster e sem criar recursos. Ele pode ser usado para validar a configuração da imagem e os requisitos de atualização. (Padronizado como `false`.)

**--force-update *FORCE\$1UPDATE***  
Quando`true`, força a atualização ignorando os erros de validação da atualização. (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.

**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**  
Identifica um ou mais validadores de configuração a serem suprimidos.  
Formato: (`ALL`\$1`type:[A-Za-z0-9]+`)

**--validation-failure-level *\$1INFO,WARNING,ERROR\$1***  
Especifica o nível de falhas de validação relatado para a atualização.

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

```
$ pcluster update-cluster -c cluster-config.yaml -n cluster-v3 -r us-east-1
{
  "cluster": {
    "clusterName": "cluster-v3",
    "cloudformationStackStatus": "UPDATE_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": "UPDATE_IN_PROGRESS"
  },
  "changeSet": [
    {
      "parameter": "HeadNode.Iam.S3Access",
      "requestedValue": {
        "BucketName": "amzn-s3-demo-bucket1",
        "KeyName": "output",
        "EnableWriteAccess": false
      }
    },
    {
      "parameter": "HeadNode.Iam.S3Access",
      "currentValue": {
        "BucketName": "amzn-s3-demo-bucket2",
        "KeyName": "logs",
        "EnableWriteAccess": true
      }
    }
  ]
}
```