Mettre à jour le cluster

Mettez à jour le cluster.

Syntaxe de demande

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

Corps de la demande

Configuration du cluster

La configuration du cluster sous forme de document YAML.

Obligatoire : oui

Nom du cluster

Nom du cluster.

Type : chaîne

Obligatoire : oui

run à sec

S'il est réglé surtrue, effectuez uniquement la validation des demandes sans créer de ressource. Utilisez ce paramètre pour valider la configuration du cluster et les exigences de mise à jour. La valeur par défaut est false.

Type : booléen

Obligatoire : non

ForceUpdate

S'il est réglé surtrue, ignorez les erreurs de validation des mises à jour et forcez la mise à jour. La valeur par défaut est false.

Type : booléen

Obligatoire : non

Région

LeRégion AWSdans lequel se trouve le cluster.

Type : chaîne

Obligatoire : non

Supprimer les validateurs

Identifie un ou plusieurs validateurs de configuration à supprimer.

Type : chaîne

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

Obligatoire : non

Exemples de valeurs valides :currentValue,requestedValue,message

validationFailureLevel

Le niveau de validation minimal pour entraîner l'échec de la mise à jour.

Type : chaîne

Valeurs valides : INFO | WARNING | ERROR

Obligatoire : non

Syntaxe de réponse

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

Corps de la réponse

Modifier le set

Modification définie pour la mise à jour du cluster.

Valeur actuelle

La valeur actuelle du paramètre à mettre à jour.

Type : chaîne

paramètre

Paramètre à mettre à jour.

Type : chaîne

Valeur demandée

La valeur demandée pour le paramètre à mettre à jour.

Type : chaîne

cluster

cloudformationStackArn

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

Type : chaîne

cloudformationStackStatus

Le CloudFormation état de la pile.

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

Nom du cluster

Nom du cluster.

Type : chaîne

État du cluster

É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

Région

LeRégion AWSdans 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 ;

La version du planificateur.

Type : chaîne

type

Type de planificateur.

Type : chaîne

version ;

AWS ParallelClusterversion utilisée pour créer le cluster.

Type : chaîne

Messages de validation

Une liste de 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

Le niveau de validation.

Type : chaîne

Valeurs valides : INFO | WARNING | ERROR

message

Le message de validation.

Type : chaîne

type

Type du validateur.

Type : chaîne

Exemple

Python

Demande

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

Réponse 200

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