# cluster

Cluster operations, from initial setup to status.
Set management node URL:

# GET /cluster/create/mons

# Parameters

  • No parameters...

# Endpoint

curl -X GET http://mgmt-node:8080/api/cluster/create/mons

# Response 200

  • idintegeroptional-
  • hostnamestringoptional-
  • ipsarrayoptional-

# Example response

[
  {
    "id": 0,
    "hostname": "string",
    "ips": [
      "string"
    ]
  }
]

# POST /cluster/create

# Parameters

  • bodyobjectoptional-
    • monsarrayoptional-
      • hostnamestringoptional-
      • serverintegeroptional-
      • ipstringoptional-

# Endpoint

curl -X POST http://mgmt-node:8080/api/cluster/create

# Example body

{
  "mons": [
    {
      "hostname": "string",
      "server": 0,
      "ip": "string"
    }
  ]
}

# Response 200

  • statusCodeintegeroptional-
  • idintegeroptional-
  • startedBystringoptional-
  • startedAtintegeroptional-
  • donebooleanoptional-
  • namestringoptional-
  • statestringoptional[WAITING, RUNNING, FINISHED, FAILED, CANCELED]
  • objectstringoptional-
  • outputstringoptional-

# Example response

{
  "statusCode": 0,
  "id": 0,
  "startedBy": "string",
  "startedAt": 0,
  "done": true,
  "name": "string",
  "state": "WAITING",
  "object": "string",
  "output": "string"
}

# GET /cluster/status

# Parameters

  • No parameters...

# Endpoint

curl -X GET http://mgmt-node:8080/api/cluster/status

# Response 200

  • cephLastUpdatednumberoptionalDuration in seconds.
  • cephStatusobjectoptional-
    • fsidstringoptional-
    • healthobjectoptional-
      • statusstringoptional[HEALTH_OK, HEALTH_WARN, HEALTH_ERR, HEALTH_UNKNOWN]
      • checksobjectoptional-
  • placementGroupsarrayoptional-
    • poolNamestringoptional-
    • poolIdintegeroptional-
    • totalintegeroptional-
    • okayintegeroptional-
    • warnintegeroptional-
    • errorintegeroptional-
  • recoveryTimeRemainingnumberoptionalDuration in seconds.
  • serversobjectoptional-
    • onlineintegeroptional-
    • totalintegeroptional-
  • mdsobjectoptional-
    • onlineintegeroptional-
    • totalintegeroptional-
    • upintegeroptional-
  • radosgwsobjectoptional-
    • onlineintegeroptional-
    • totalintegeroptional-
  • iscsiobjectoptional-
    • onlineintegeroptional-
    • totalintegeroptional-
  • nfsGatewaysobjectoptional-
    • onlineintegeroptional-
    • totalintegeroptional-
  • smbGatewaysobjectoptional-
    • onlineintegeroptional-
    • totalintegeroptional-
  • licenseActivebooleanoptional-
  • croitUptimenumberoptionalDuration in seconds.

# Example response

{
  "cephLastUpdated": ,
  "cephStatus": {
    "fsid": "string",
    "health": {
      "status": "HEALTH_OK",
      "checks": {}
    }
  },
  "placementGroups": [
    {
      "poolName": "string",
      "poolId": 0,
      "total": 0,
      "okay": 0,
      "warn": 0,
      "error": 0
    }
  ],
  "recoveryTimeRemaining": ,
  "servers": {
    "online": 0,
    "total": 0
  },
  "mds": {
    "online": 0,
    "total": 0,
    "up": 0
  },
  "radosgws": {
    "online": 0,
    "total": 0
  },
  "iscsi": {
    "online": 0,
    "total": 0
  },
  "nfsGateways": {
    "online": 0,
    "total": 0
  },
  "smbGateways": {
    "online": 0,
    "total": 0
  },
  "licenseActive": true,
  "croitUptime": 
}

# GET /cluster/status/detail

# Parameters

  • No parameters...

# Endpoint

curl -X GET http://mgmt-node:8080/api/cluster/status/detail

# Response 200

# Example response

{}