Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Actualiza un clúster existente para que coincida con los ajustes de un archivo de configuración especificado.

**nota**  
 La actualización del clúster solo se realiza correctamente si todos los nodos del clúster la han aplicado correctamente. Si se produce un error en la actualización, consulte la [Visualización de `clusterStatus` como `UPDATE_FAILED` con el comando `pcluster describe-cluster`](troubleshooting-fc-v3-update-cluster.md#update-cluster-failure-v3) sección para obtener instrucciones sobre la solución 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 con nombre
<a name="pcluster-v3.update-cluster.namedargs"></a>

**-h, --help**  
Muestra el texto de ayuda de `pcluster update-cluster`.

**--cluster-configuration, -c {{CLUSTER\_CONFIGURATION}}**  
Especifica el archivo YAML de configuración del clúster.

**--cluster-name, -n {{CLUSTER\_NAME}}**  
Especifica el nombre del clúster.

**--debug**  
Habilita del registro de depuración.

**--dryrun {{DRYRUN}}**  
Cuando se establece en `true`, realiza la validación sin actualizar el clúster ni crear ningún recurso. Se puede utilizar para validar la configuración de la imagen y los requisitos de actualización (el valor predeterminado es `false`).

**--force-update {{FORCE\_UPDATE}}**  
Cuando se establece en `true`, fuerza la actualización ignorando los errores de validación de la actualización (el valor predeterminado es `false`).

**--query {{QUERY}}**  
Especifica la JMESPath consulta que se va a realizar en la salida.

**--region, -r {{REGION}}**  
Especifica el Región de AWS que se va a utilizar. Región de AWS Debe especificarse mediante la [`Region`](cluster-configuration-file-v3.md#yaml-Region)configuración del archivo de configuración del clúster, la variable de `AWS_DEFAULT_REGION` entorno, la `region` configuración de la `[default]` sección del `~/.aws/config` archivo o el `--region` parámetro.

**--suppress-validators {{ SUPPRESS\_VALIDATORS}} [{{SUPPRESS\_VALIDATORS ...}}]**  
Identifica uno o más validadores de configuración para suprimirlos.  
Formato: (`ALL`\|`type:[A-Za-z0-9]+`)

**--validation-failure-level {{{INFO,WARNING,ERROR}}}**  
Especifica el nivel de errores de validación notificados para la actualización.

**Ejemplo que utiliza AWS ParallelCluster la versión 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
      }
    }
  ]
}
```