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

**Clustername**  
Der Name des Clusters  
Type: Zeichenkette  
Erforderlich: Ja

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

**ForceUpdate**  
Wenn auf gesetzt`true`, werden die Fehler bei der Überprüfung des Updates ignoriert und das Update erzwungen. 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 zu unterdrückende Konfigurationsvalidatoren.  
Type: Zeichenkette  
Format: `(ALL|type:[A-Za-z0-9]+)`  
Erforderlich: Nein  
Beispiel für gültige Werte:`currentValue`,, `requestedValue` `message`

**validationFailureLevel**  
Die Mindestvalidierungsstufe, die dazu führen soll, 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 zu aktualisierenden Parameters.  
Type: Zeichenkette  
**Parameter**  
Der zu aktualisierende Parameter.  
Type: Zeichenkette  
**Angeforderter Wert**  
Der angeforderte Wert für den zu aktualisierenden Parameter.  
Type: Zeichenkette

**Cluster**    
**cloudformationStackArn**  
Der Amazon-Ressourcenname (ARN) des CloudFormation Hauptstapels.  
Type: Zeichenkette  
**cloudformationStackStatus**  
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`  
**Clustername**  
Der Name des Clusters.  
Type: Zeichenkette  
**Cluster-Status**  
Der Clusterstatus.  
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 wurde.  
Type: Zeichenkette  
**Scheduler**    
**Metadaten**  
Die Scheduler-Metadaten.    
**Name**  
Der Name des Schedulers.  
Type: Zeichenkette  
**version**  
Die Scheduler-Version.  
Type: Zeichenkette  
**Typ**  
Der Scheduler-Typ.  
Type: Zeichenkette

**version**  
AWS ParallelCluster Version, die zur Erstellung des Clusters verwendet wird.  
Type: Zeichenkette

**Bestätigungsnachrichten**  
Eine Liste von Nachrichten mit einer Gültigkeitsstufe unter. `validationFailureLevel` Die Liste der Nachrichten wird während der Konfigurationsvalidierung gesammelt.    
**id**  
Die ID des Validators.  
Type: Zeichenkette  
**level**  
Die Validierungsebene.  
Type: Zeichenkette  
Zulässige Werte: `INFO | WARNING | ERROR`  
**Nachricht**  
Die Bestätigungsnachricht.  
Type: Zeichenkette  
**Typ**  
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'
  }
}
```

------