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 de clústeres

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 se establece entrue, solo realice la validación de la solicitud sin crear ningún recurso. Utilice este parámetro para validar los requisitos de configuración y actualización del clúster. El valor predeterminado es false.

Tipo: booleano

Obligatorio: no

Forzar actualización

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

El lugar en elRegión de AWS que se encuentra el clúster.

Tipo: cadena

Requerido: No

Suprime 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 de validación mínimo 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

changeSet

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 de recurso de Amazon (ARN) de la CloudFormation pila principal.

Tipo: cadena

cloudformationStackStatus

El estado CloudFormation 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

El lugar en elRegión de AWS que se creó el clúster.

Tipo: cadena

programador

metadatos

Los metadatos del planificador.

nombre

El nombre del programador.

Tipo: cadena

versión

La versión del planificador.

Tipo: cadena

type

El tipo de planificador.

Tipo: cadena

versión

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

Tipo: cadena

Mensajes de validación

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 valor.

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)

200 Respuesta

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