createCluster

Erstellen Sie einen verwalteten Cluster in einemAWS-Region.

Erforderliche Syntax

POST /v3/clusters
{
  "clusterName": "string",
  "clusterConfiguration": "string",
  "dryrun": boolean,
  "region": "string",
  "rollbackOnFailure", boolean,
  "suppressValidators": [ "string" ],
  "validationFailureLevel": "string"
}

Anforderungstext

Cluster-Konfiguration

Die Cluster-Konfiguration als YAML-Dokument.

Typ: Zeichenfolge

Erforderlich: Ja

Clustername

Der Name des zu erstellenden Clusters.

Der Name muss mit einem alphabetischen Zeichen beginnen. Der Name kann bis zu 60 Zeichen lang sein. WennSlurmDie Kontoführung ist aktiviert, der Name kann bis zu 40 Zeichen lang sein.

Typ: Zeichenfolge

Erforderlich: Ja

Trockenlauf

Wenn gesetzt auftrueführt nur eine Anforderungsvalidierung durch, ohne eine Ressource zu erstellen. Verwenden Sie diesen Parameter, um die Clusterkonfiguration zu validieren. Der Standardwert ist false.

Typ: boolescher Wert

Required: No

region

DerAWS-Regionin dem sich der Cluster befindet.

Typ: Zeichenkette

Required: No

rollbackOnFailure

Wenn gesetzt auftrueerfolgt ein Cluster-Stack-Rollback, wenn der Cluster nicht erstellt werden kann. Der Standardwert ist true.

Typ: boolescher Wert

Required: No

Unterdrücken Sie Validatoren

Identifizieren Sie einen oder mehrere Konfigurationsvalidatoren, die unterdrückt werden sollen.

Typ: Liste von Zeichenketten

Format: (ALL|type:[A-Za-z0-9]+)

Required: No

validationFailureLevel

Die Mindestvalidierungsstufe, die dazu führt, dass die Clustererstellung fehlschlägt. Der Standardwert ist ERROR.

Typ: Zeichenfolge

Zulässige Werte: INFO | WARNING | ERROR

Required: No

Antwortsyntax

{
  "cluster": {
    "clusterName": "string",
    "region": "string",
    "version": "string",
    "cloudformationStackArn": "string",
    "cloudformationStackStatus": "CREATE_IN_PROGRESS",
    "clusterStatus": "CREATE_IN_PROGRESS",
    "scheduler": {
      "type": "string",
      "metadata": {
        "name": "string",
        "version": "string"
      }
    }
  },
  "validationMessages": [
    {
      "id": "string",
      "type": "string",
      "level": "INFO",
      "message": "string"
    }
  ]
}

Antworttext

Clustername

Der Name des Clusters.

Typ: Zeichenfolge

cloudformationStackArn

Der Amazon-Ressourcenname (ARN) der Haupt-Ressource CloudFormation Stapel.

Typ: Zeichenfolge

cloudformationStackStatus

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

Cluster-Status

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

DieAWS-Regionin 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

type

Der Scheduler-Typ.

Typ: Zeichenfolge

Version

DieAWS ParallelClusterVersion, die zur Erstellung des Clusters verwendet wird.

Typ: Zeichenfolge

validation_messages

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

ID

Die ID des Validators.

Typ: Zeichenfolge

level

Typ: Zeichenfolge

Zulässige Werte: INFO | WARNING | ERROR

Nachricht

Eine Bestätigungsnachricht.

Typ: Zeichenfolge

type

Der Typ des Validators.

Typ: Zeichenfolge

Beispiel

Python

Anforderung

$ create_cluster(cluster_name_3x, cluster-config.yaml)

200 Antwort

{
  'cluster': {
    'cloudformation_stack_arn': 'arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-3x/e0462730-50b5-11ed-99a3-0a5ddc4a34c7',
    'cloudformation_stack_status': 'CREATE_IN_PROGRESS',
    'cluster_name': 'cluster-3x',
    'cluster_status': 'CREATE_IN_PROGRESS',
    'region': 'us-east-1',
    'scheduler': {
      'type': 'slurm'
    },
    'version': '3.2.1'
  }
}