Actualizar clúster

Actualice el clúster.

Sintaxis de la solicitud

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

Cuerpo de la solicitud

Configuración del clúster

La configuración del clúster como documento YAML.

Obligatorio: sí

Nombre del clúster

El nombre del clúster.

Tipo: cadena

Obligatorio: sí

funcionamiento en seco

Si está configurado entrue, solo valide la solicitud sin crear ningún recurso. Utilice este parámetro para validar la configuración del clúster y los requisitos de actualización. El valor predeterminado es false.

Tipo: booleano

Obligatorio: no

ForceUpdate

Si se establece entrue, ignore los errores de validación de la actualización y fuerce la actualización. El valor predeterminado es false.

Tipo: booleano

Obligatorio: no

region

ElRegión de AWSen el que se encuentra el clúster.

Tipo: cadena

Requerido: No

Suprime los validadores

Identifica uno o más validadores de configuración para suprimirlos.

Tipo: cadena

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

Obligatorio: no

Ejemplos de valores válidos:currentValue,requestedValue,message

validationFailureLevel

El nivel mínimo de validación para provocar un error en la actualización.

Tipo: cadena

Valores válidos: INFO | WARNING | ERROR

Obligatorio: no

Sintaxis de la respuesta

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

Cuerpo de respuesta

Conjunto de cambios

El conjunto de cambios para la actualización del clúster.

Valor actual

El valor actual del parámetro que se va a actualizar.

Tipo: cadena

parameter

El parámetro que se va a actualizar.

Tipo: cadena

Valor solicitado

El valor solicitado para el parámetro que se va a actualizar.

Tipo: cadena

clúster

cloudformationStackArn

El nombre del recurso de Amazon (ARN) del recurso principal CloudFormation pila.

Tipo: cadena

cloudformationStackStatus

El CloudFormation estado de la pila.

Tipo: cadena

Valores válidos: 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

Nombre del clúster

El nombre del clúster.

Tipo: cadena

Estado del clúster

El estado del clúster.

Tipo: cadena

Valores válidos: CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | UPDATE_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_FAILED

region

ElRegión de AWSen el que se creó el clúster.

Tipo: cadena

programador

metadatos

Los metadatos del planificador.

nombre

El nombre del planificador.

Tipo: cadena

versión

La versión del programador.

Tipo: cadena

type

El tipo de planificador.

Tipo: cadena

versión

AWS ParallelClusterversión que se utiliza para crear el clúster.

Tipo: cadena

Mensajes de validación

Una lista de mensajes con un nivel de validación inferior avalidationFailureLevel. La lista de mensajes se recopila durante la validación de la configuración.

id

El ID del validador.

Tipo: cadena

level

El nivel de validación.

Tipo: cadena

Valores válidos: INFO | WARNING | ERROR

message

El mensaje de validación.

Tipo: cadena

type

El tipo de validador.

Tipo: cadena

Ejemplo

Python

Solicitud

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

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