Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Cluster aktualisieren
<a name="update-cluster"></a>

Aktualisieren Sie den Cluster.

**Topics**
+ [Erforderliche Syntax](#update-cluster-request)
+ [Anforderungstext](#update-cluster-request-body)
+ [Antwortsyntax](#update-cluster-response)
+ [Antworttext](#update-cluster-response-body)
+ [Beispiel](#update-cluster-example)

## Erforderliche Syntax
<a name="update-cluster-request"></a>

```
PUT /v3/clusters/{{{clusterName}}}
{
  "clusterConfiguration": "string",
  "dryrun": boolean,
  "forceUpdate": boolean,
  "region": "string",
  "suppressValidators": "string",
  "validationFailureLevel": "string"
}
```

## Anforderungstext
<a name="update-cluster-request-body"></a>

**Cluster-Konfiguration**  
Die Cluster-Konfiguration als YAML-Dokument.  
Erforderlich: Ja

**Cluster-Name**  
Der Name des Clusters.  
Type: Zeichenkette  
Erforderlich: Ja

**Trockenlauf**  
Wenn auf gesetzt`true`, führen Sie nur eine Anforderungsvalidierung durch, ohne eine Ressource zu erstellen. Verwenden Sie diesen Parameter, um die Clusterkonfiguration zu überprüfen und die Anforderungen zu aktualisieren. Der Standardwert ist `false`.  
Typ: Boolesch  
Erforderlich: Nein

**Aktualisierung erzwingen**  
Wenn auf gesetzt`true`, ignorieren Sie die Fehler bei der Überprüfung des Updates und erzwingen Sie das Update. Der Standardwert ist `false`.  
Typ: Boolesch  
Erforderlich: Nein

**Region**  
Der AWS-Region , in dem sich der Cluster befindet.  
Type: Zeichenkette  
Erforderlich: Nein

**Validatoren unterdrücken**  
Identifiziert einen oder mehrere Konfigurationsvalidatoren, die unterdrückt werden sollen.  
Type: Zeichenkette  
Format: `(ALL|type:[A-Za-z0-9]+)`  
Erforderlich: Nein  
Beispiel für gültige Werte:`currentValue`,, `requestedValue` `message`

**Validierung FailureLevel**  
Die Mindestvalidierungsstufe, die dazu führt, dass das Update fehlschlägt.  
Type: Zeichenkette  
Zulässige Werte: `INFO | WARNING | ERROR`  
Erforderlich: Nein

## Antwortsyntax
<a name="update-cluster-response"></a>

```
{
  "cluster": {
    "clusterName": "string",
    "region": "string",
    "version": "string",
    "cloudformationStackArn": "string",
    "cloudformationStackStatus": "UPDATE_IN_PROGRESS",
    "clusterStatus": "UPDATE_IN_PROGRESS",
    "scheduler": {
      "type": "string",
      "metadata": {
        "name": "string",
        "version": "string"
      }
    }
  },
  "validationMessages": [
    {
      "id": "string",
      "type": "string",
      "level": "INFO",
      "message": "string"
    }
  ],
  "changeSet": [
    {
      "parameter": "string",
      "currentValue": "string",
      "requestedValue": "string"
    }
  ]
}
```

## Antworttext
<a name="update-cluster-response-body"></a>

**ChangeSet**  
Der Änderungssatz für das Cluster-Update.    
**Aktueller Wert**  
Der aktuelle Wert des Parameters, der aktualisiert werden soll.  
Type: Zeichenkette  
**Parameter**  
Der Parameter, der aktualisiert werden soll.  
Type: Zeichenkette  
**Angeforderter Wert**  
Der angeforderte Wert für den Parameter, der aktualisiert werden soll.  
Type: Zeichenkette

**Cluster**    
**Wolkenbildung StackArn**  
Der Amazon-Ressourcenname (ARN) des CloudFormation Hauptstapels.  
Type: Zeichenkette  
**Wolkenbildung StackStatus**  
Der CloudFormation Stack-Status.  
Type: Zeichenkette  
Zulässige Werte: `CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | ROLLBACK_IN_PROGRESS | ROLLBACK_FAILED | ROLLBACK_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_ROLLBACK_IN_PROGRESS | UPDATE_ROLLBACK_FAILED | UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_ROLLBACK_COMPLETE`  
**Cluster-Name**  
Der Name des Clusters.  
Type: Zeichenkette  
**Cluster-Status**  
Der Cluster-Status.  
Type: Zeichenkette  
Zulässige Werte: `CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_FAILED`  
**Region**  
Der, AWS-Region in dem der Cluster erstellt wird.  
Type: Zeichenkette  
**Scheduler**    
**Metadaten**  
Die Scheduler-Metadaten.    
**Name**  
Der Name des Schedulers.  
Type: Zeichenkette  
**version**  
Die Scheduler-Version.  
Type: Zeichenkette  
**type**  
Der Scheduler-Typ.  
Type: Zeichenkette

**version**  
AWS ParallelCluster Version, die zum Erstellen des Clusters verwendet wird.  
Type: Zeichenkette

**Meldungen zur Validierung**  
Eine Liste von Nachrichten mit einer Validierungsstufe unter. `validationFailureLevel` Die Liste der Nachrichten wird bei der Konfigurationsüberprüfung erfasst.    
**id**  
Die ID des Validators.  
Type: Zeichenkette  
**level**  
Die Validierungsebene.  
Type: Zeichenkette  
Zulässige Werte: `INFO | WARNING | ERROR`  
**Nachricht**  
Die Bestätigungsnachricht.  
Type: Zeichenkette  
**type**  
Der Typ des Validators.  
Type: Zeichenkette

## Beispiel
<a name="update-cluster-example"></a>

------
#### [ Python ]

**Anforderung**

```
$ update_cluster({{cluster_name_3x}}, {{path/config-file.yaml}})
```

**200 Antwort **

```
{
  'change_set': [
    {
      'current_value': '10',
      'parameter': 'Scheduling.SlurmQueues[queue1].ComputeResources[t2micro].MaxCount',
      'requested_value': '15'
    }
  ],
  'cluster': {
    'cloudformation_stack_arn': 'arn:aws:cloudformation:us-east-1:123456789012:stack/test-api-cluster/e0462730-50b5-11ed-99a3-0a5ddc4a34c7',
    'cloudformation_stack_status': 'UPDATE_IN_PROGRESS',
    'cluster_name': 'cluster-3x',
    'cluster_status': 'UPDATE_IN_PROGRESS',
    'region': 'us-east-1',
    'scheduler': {
      'type': 'slurm'
    },
    'version': '3.2.1'
  }
}
```

------