Endpoint

/v2/cluster/create

POST

Form a cluster with the given set of node UUIDs and admin password.

Parameters

This resource has no parameters.

Request

Schema

{
  "description": "api_cluster_creation_request_v2",
  "type": "object",
  "properties": {
    "eula_accepted": {
      "description": "User accepts the End User License Agreement",
      "type": "boolean"
    },
    "cluster_name": {
      "description": "Name of the cluster",
      "type": "string"
    },
    "node_uuids": {
      "type": "array",
      "items": {
        "description": "List of node uuids to form a cluster with",
        "type": "string"
      }
    },
    "node_ips": {
      "type": "array",
      "items": {
        "description": "List of node IPs to form a cluster with",
        "type": "string"
      }
    },
    "admin_password": {
      "description": "The administrator password",
      "type": "string",
      "format": "password"
    },
    "host_instance_id": {
      "description": "EC2 instance ID for the node handling this request",
      "type": "string"
    },
    "blocks_per_stripe": {
      "description": "Number of blocks per stripe in the cluster's erasure coding configuration",
      "type": "number"
    },
    "max_drive_failures": {
      "description": "The maximum number of drive failures this cluster will be able to sustain",
      "type": "number"
    },
    "max_node_failures": {
      "description": "The maximum number of node failures this cluster will be able to sustain",
      "type": "number"
    }
  }
}

Response

Codes

Code Description
202 Return value on success