createCluster

Créez un cluster géré dans un Région AWS.

Syntaxe de demande

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

Corps de la demande

Configuration du cluster

La configuration du cluster sous forme de document YAML.

Type : chaîne

Obligatoire : oui

Nom du cluster

Nom du cluster à créer.

Le nom doit commencer par un caractère alphabétique. Le nom peut comporter jusqu'à 60 caractères. Si la Slurm comptabilité est activée, le nom peut comporter jusqu'à 40 caractères.

Type : chaîne

Obligatoire : oui

run à sec

Si ce paramètre est défini surtrue, effectuez uniquement la validation des demandes sans créer de ressource. Utilisez ce paramètre pour valider la configuration du cluster. L’argument par défaut est false.

Type : valeur booléenne

Obligatoire : non

region

Le dans Région AWS lequel se trouve le cluster.

Type : chaîne

Obligatoire : non

rollbackOnFailure

Si cette valeur est définie surtrue, la restauration de la pile du cluster se produit si le cluster ne parvient pas à être créé. L’argument par défaut est true.

Type : valeur booléenne

Obligatoire : non

Supprimer les validateurs

Identifiez un ou plusieurs validateurs de configuration à supprimer.

Type : liste de chaînes

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

Obligatoire : non

validationFailureLevel

Le niveau de validation minimal qui entraîne l'échec de la création du cluster. L’argument par défaut est ERROR.

Type : chaîne

Valeurs valides : INFO | WARNING | ERROR

Obligatoire : non

Syntaxe de réponse

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

Corps de la réponse

Nom du cluster

Nom du cluster.

Type : chaîne

cloudformationStackArn

Le nom de ressource Amazon (ARN) de la CloudFormation pile principale.

Type : chaîne

cloudformationStackStatus

Type : chaîne

Valeurs valides : 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

État du cluster

Type : chaîne

Valeurs valides : CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_FAILED

region

Le dans Région AWS lequel le cluster est créé.

Type : chaîne

planificateur

métadonnées

Les métadonnées du planificateur

name

Nom du planificateur.

Type : chaîne

version

Version du planificateur.

Type : chaîne

type

Type de planificateur.

Type : chaîne

version

AWS ParallelCluster Version utilisée pour créer le cluster.

Type : chaîne

messages_de validation

Liste des messages dont le niveau de validation est inférieur àvalidationFailureLevel. La liste des messages est collectée lors de la validation de la configuration.

id

L'ID du validateur.

Type : chaîne

level

Type : chaîne

Valeurs valides : INFO | WARNING | ERROR

message

Un message de validation.

Type : chaîne

type

Type du validateur.

Type : chaîne

Exemple

Python

Demande

$ create_cluster(cluster_name_3x, cluster-config.yaml)

Réponse 200

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