updateCluster - AWS ParallelCluster
Erforderliche SyntaxAnforderungstextAntwortsyntaxAntworttextBeispiel

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.

updateCluster

Aktualisieren Sie den Cluster.

Erforderliche Syntax

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

Anforderungstext

clusterConfiguration

Die Clusterkonfiguration als YAML Dokument.

Erforderlich: Ja

clusterName

Der Name des Clusters

Typ: Zeichenfolge

Erforderlich: Ja

Trockenlauf

Wenn auf gesetzttrue, 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 dieser Wert auf gesetzt isttrue, werden die Fehler bei der Aktualisierungsvalidierung ignoriert und das Update erzwungen. Der Standardwert ist false.

Typ: Boolesch

Erforderlich: Nein

Region

Der AWS-Region , in dem sich der Cluster befindet.

Typ: Zeichenfolge

Erforderlich: Nein

suppressValidators

Identifiziert einen oder mehrere zu unterdrückende Konfigurationsvalidatoren.

Typ: Zeichenfolge

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.

Typ: Zeichenfolge

Zulässige Werte: INFO | WARNING | ERROR

Erforderlich: Nein

Antwortsyntax

{
  "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

changeSet

Der Änderungssatz für das Cluster-Update.

currentValue

Der aktuelle Wert des zu aktualisierenden Parameters.

Typ: Zeichenfolge

Parameter

Der zu aktualisierende Parameter.

Typ: Zeichenfolge

requestedValue

Der angeforderte Wert für den zu aktualisierenden Parameter.

Typ: Zeichenfolge

Cluster
cloudformationStackArn

Der Amazon-Ressourcenname (ARN) des CloudFormation Hauptstapels.

Typ: Zeichenfolge

cloudformationStackStatus

Der CloudFormation Stack-Status.

Typ: Zeichenfolge

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.

Typ: Zeichenfolge

clusterStatus

Der Clusterstatus.

Typ: Zeichenfolge

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.

Typ: Zeichenfolge

Scheduler
Metadaten

Die Scheduler-Metadaten.

Name

Der Name des Schedulers.

Typ: Zeichenfolge

version

Die Scheduler-Version.

Typ: Zeichenfolge

Typ

Der Scheduler-Typ.

Typ: Zeichenfolge

version

AWS ParallelCluster Version, die zur Erstellung des Clusters verwendet wird.

Typ: Zeichenfolge

validationMessages

Eine Liste von Nachrichten mit einer niedrigeren Validierungsstufe alsvalidationFailureLevel. Die Liste der Nachrichten wird während der Konfigurationsvalidierung gesammelt.

id

Die ID des Validators.

Typ: Zeichenfolge

level

Die Validierungsebene.

Typ: Zeichenfolge

Zulässige Werte: INFO | WARNING | ERROR

Nachricht

Die Bestätigungsnachricht.

Typ: Zeichenfolge

Typ

Der Typ des Validators.

Typ: Zeichenfolge

Beispiel

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'
  }
}