Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# `pcluster update-cluster`
<a name="pcluster.update-cluster-v3"></a>

Met à jour un cluster existant pour qu'il corresponde aux paramètres d'un fichier de configuration spécifié.

**Note**  
 La mise à jour du cluster ne réussit que si tous les nœuds du cluster ont correctement appliqué la mise à jour. Si la mise à jour échoue, reportez-vous à la [Voir `clusterStatus` c'est `UPDATE_FAILED` avec `pcluster describe-cluster` commande](troubleshooting-fc-v3-update-cluster.md#update-cluster-failure-v3) section pour obtenir des conseils de dépannage. 

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

## Arguments nommés
<a name="pcluster-v3.update-cluster.namedargs"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster update-cluster`.

**--cluster-configuration, -c *CLUSTER\$1CONFIGURATION***  
Spécifie le fichier de configuration du cluster YAML.

**--cluster-name, -n *CLUSTER\$1NAME***  
Spécifie le nom du cluster.

**--debug**  
Active la journalisation du débogage.

**--dryrun *DRYRUN***  
Quand`true`, effectue la validation sans mettre à jour le cluster ni créer de ressources. Il peut être utilisé pour valider la configuration de l'image et les exigences de mise à jour. (La valeur par défaut est`false`.)

**--force-update *FORCE\$1UPDATE***  
Quand`true`, force la mise à jour en ignorant les erreurs de validation de mise à jour. (La valeur par défaut est`false`.)

**--query *QUERY***  
Spécifie la JMESPath requête à exécuter sur la sortie.

**--region, -r *REGION***  
Spécifie le Région AWS à utiliser. Le Région AWS doit être spécifié à l'aide du [`Region`](cluster-configuration-file-v3.md#yaml-Region)paramètre du fichier de configuration du cluster, de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.

**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**  
Identifie un ou plusieurs validateurs de configuration à supprimer.  
Format : (`ALL`\$1`type:[A-Za-z0-9]+`)

**--validation-failure-level *\$1INFO,WARNING,ERROR\$1***  
Spécifie le niveau d'échecs de validation signalés pour la mise à jour.

**Exemple utilisant AWS ParallelCluster la version 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
      }
    }
  ]
}
```