createCluster

Cree un clúster gestionado en unRegión de AWS.

Sintaxis de la solicitud

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

Cuerpo de la solicitud

Configuración de clústeres

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

Tipo: cadena

Obligatorio: sí

Nombre del clúster

El nombre del clúster que se creará.

El nombre debe comenzar por un carácter alfabético. El nombre puede tener hasta 60 caracteres. Si laSlurm contabilidad está habilitada, el nombre puede tener hasta 40 caracteres.

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 la configuración de clúster. 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

rollbackOnFailure

Si se establece entrue, la reversión de la pila de clústeres se produce si el clúster no se crea. El valor predeterminado es true.

Tipo: booleano

Obligatorio: no

Suprime validadores

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

Tipo: lista de cadenas

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

Obligatorio: no

validationFailureLevel

El nivel de validación mínimo que hace que falle la creación del clúster. El valor predeterminado es ERROR.

Tipo: cadena

Valores válidos: INFO | WARNING | ERROR

Obligatorio: no

Sintaxis de la respuesta

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

Cuerpo de respuesta

Nombre del clúster

El nombre del clúster.

Tipo: cadena

cloudformationStackArn

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

Tipo: cadena

cloudformationStackStatus

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

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

LaAWS ParallelCluster versió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

Tipo: cadena

Valores válidos: INFO | WARNING | ERROR

message

Un mensaje de validación.

Tipo: cadena

type

El tipo de validador.

Tipo: cadena

Ejemplo

Python

Solicitud

$ create_cluster(cluster_name_3x, cluster-config.yaml)

200 Respuesta

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