Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# createCluster
<a name="create-cluster"></a>

Cree un clúster administrado en una Región de AWS.

**Topics**
+ [Sintaxis de la solicitud](#create-cluster-request)
+ [Cuerpo de la solicitud](#create-cluster-request-body)
+ [Sintaxis de la respuesta](#create-cluster-response)
+ [Cuerpo de respuesta](#create-cluster-response-body)
+ [Ejemplo](#create-cluster-example)

## Sintaxis de la solicitud
<a name="create-cluster-request"></a>

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

## Cuerpo de la solicitud
<a name="create-cluster-request-body"></a>

**clusterConfiguration**  
La configuración del clúster como documento YAML.  
Tipo: cadena  
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: cadena  
Obligatorio: sí

**dryrun**  
Si se establece en`true`, solo valide la solicitud, pero no cree 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**  
El lugar en el Región de AWS que se encuentra el clúster.  
Tipo: cadena  
Requerido: 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: cadena  
Valores válidos: `INFO | WARNING | ERROR`  
Obligatorio: no

## Sintaxis de la respuesta
<a name="create-cluster-response"></a>

```
{
  "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
<a name="create-cluster-response-body"></a>

**clusterName**  
El nombre del clúster.  
Tipo: cadena

**cloudformationStackArn**  
El nombre de recurso de Amazon (ARN) de la pila principal CloudFormation .  
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`

**clusterStatus**  
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 el Región de AWS que se creó el clúster.  
Tipo: cadena

**programador**    
**metadatos**  
Los metadatos del programador.    
**nombre**  
El nombre del programador.  
Tipo: cadena  
**versión**  
La versión del programador.  
Tipo: cadena  
**type**  
El tipo de programador.  
Tipo: cadena

**versión**  
La AWS ParallelCluster versión que se utiliza para crear el clúster.  
Tipo: cadena

**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: cadena  
**nivel**  
Tipo: cadena  
Valores válidos: `INFO | WARNING | ERROR`  
**message**  
Un mensaje de validación.  
Tipo: cadena  
**type**  
El tipo de validador.  
Tipo: cadena

## Ejemplo
<a name="create-cluster-example"></a>

------
#### [ 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"
  }
}
```

------