createCluster

Cree un clúster administrado en una Regió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

clusterConfiguration

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

Tipo: String

Obligatorio: sí

clusterName

El nombre del clúster que se creará.

El nombre debe empezar por un carácter alfabético. El nombre puede tener un máximo de 60 caracteres. Si la contabilidad de Slurm está habilitada, el nombre puede tener hasta 40 caracteres.

Tipo: String

Obligatorio: sí

dryrun

Si se establece en true, solo realiza la validación de la solicitud sin crear ningún recurso. Use este parámetro para validar la configuración del clúster. El valor predeterminado es false.

Tipo: booleano

Obligatorio: no

region

La Región de AWS en la que se encuentra el clúster.

Tipo: String

Obligatorio: no

rollbackOnFailure

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

Tipo: booleano

Obligatorio: no

suppressValidators

Identifica 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 mínimo de validación que provoca un error en la creación del clúster. El valor predeterminado es ERROR.

Tipo: String

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

clusterName

El nombre del clúster.

Tipo: String

cloudformationStackArn

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

Tipo: String

cloudformationStackStatus

Tipo: String

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

clusterStatus

Tipo: String

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

La Región de AWS en la que se crea el clúster.

Tipo: String

programador

metadatos

Los metadatos del programador.

nombre

El nombre del programador.

Tipo: String

version

La versión del programador.

Tipo: String

type

El tipo de programador.

Tipo: String

version

La versión de AWS ParallelCluster que se utiliza para crear el clúster.

Tipo: String

validation_messages

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

id

El identificador del validador.

Tipo: String

level

Tipo: String

Valores válidos: INFO | WARNING | ERROR

message

Un mensaje de validación.

Tipo: String

type

El tipo de validador.

Tipo: String

Ejemplo

Python

Solicitud

$ create_cluster(cluster_name_3x, cluster-config.yaml)

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