cluster

Cluster operations, from initial setup to status.

GET /cluster/create/mons

Parameters

No parameters...

Endpoint

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

Response 200

id
integer
optional
-
hostname
string
optional
-
ips
array
optional
-

Example response

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

POST /cluster/create

Parameters

body
object
optional
-

Endpoint

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

Example body

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

Response 200

result
object
optional
-
name
string
optional
-
id
integer
optional
-
state
string
optional
[WAITING, RUNNING, FINISHED, FAILED, CANCELED]
statusCode
integer
optional
-
done
boolean
optional
-
startedAt
integer
optional
-
startedBy
string
optional
-
object
string
optional
-
output
string
optional
-

Example response

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

GET /cluster/status

Parameters

No parameters...

Endpoint

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

Response 200

timestamp
integer
optional
The timestamp at which this status report was created, note that the Ceph state can be up to 30 seconds older if Ceph is slow to respond.
cephLastUpdated
number
optional
Duration in seconds.
cephStatus
object
optional
-
healthDetails
object
optional
-
placementGroups
array
optional
-
recoveryTimeRemaining
number
optional
Duration in seconds.
servers
object
optional
-
mds
object
optional
-
utilizationByDeviceClass
object
optional
-
radosgws
object
optional
-
iscsi
object
optional
-
nfsGateways
object
optional
-
smbGateways
object
optional
-
licenseActive
boolean
optional
-
licenseValidUntil
number
optional
Duration in seconds.
croitUptime
number
optional
Duration in seconds.

Example response

{
  "timestamp": 0,
  "cephLastUpdated": 0,
  "cephStatus": {
    "fsid": "string",
    "health": {
      "status": "HEALTH_OK",
      "checks": {}
    },
    "extraFields": {},
    "activeMdsServers": [
      {
        "filesystemId": 0,
        "rank": 0,
        "name": "string",
        "status": "string"
      }
    ],
    "activeMgr": "string"
  },
  "healthDetails": {
    "status": "HEALTH_OK",
    "checks": {}
  },
  "placementGroups": [
    {
      "poolName": "string",
      "poolId": 0,
      "total": 0,
      "okay": 0,
      "warn": 0,
      "error": 0
    }
  ],
  "recoveryTimeRemaining": 0,
  "servers": {
    "healthy": true,
    "online": 0,
    "total": 0
  },
  "mds": {
    "online": 0,
    "total": 0,
    "up": 0
  },
  "utilizationByDeviceClass": {},
  "radosgws": {
    "healthy": true,
    "online": 0,
    "total": 0
  },
  "iscsi": {
    "healthy": true,
    "online": 0,
    "total": 0
  },
  "nfsGateways": {
    "healthy": true,
    "online": 0,
    "total": 0
  },
  "smbGateways": {
    "healthy": true,
    "online": 0,
    "total": 0
  },
  "licenseActive": true,
  "licenseValidUntil": 0,
  "croitUptime": 0
}
                  

GET /cluster/status/history

Parameters

No parameters...

Endpoint

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

Response 200

Example response

[
  0
]
                  

GET /cluster/status/history/{timestamp}

Parameters

timestamp
integer
path
Timestamp as returned by /cluster/status/history

Endpoint

curl -X GET http://mgmt-node:8080/api/cluster/status/history/{timestamp}
                

Response 200

timestamp
integer
optional
The timestamp at which this status report was created, note that the Ceph state can be up to 30 seconds older if Ceph is slow to respond.
cephLastUpdated
number
optional
Duration in seconds.
cephStatus
object
optional
-
healthDetails
object
optional
-
placementGroups
array
optional
-
recoveryTimeRemaining
number
optional
Duration in seconds.
servers
object
optional
-
mds
object
optional
-
utilizationByDeviceClass
object
optional
-
radosgws
object
optional
-
iscsi
object
optional
-
nfsGateways
object
optional
-
smbGateways
object
optional
-
licenseActive
boolean
optional
-
licenseValidUntil
number
optional
Duration in seconds.
croitUptime
number
optional
Duration in seconds.

Example response

{
  "timestamp": 0,
  "cephLastUpdated": 0,
  "cephStatus": {
    "fsid": "string",
    "health": {
      "status": "HEALTH_OK",
      "checks": {}
    },
    "extraFields": {},
    "activeMdsServers": [
      {
        "filesystemId": 0,
        "rank": 0,
        "name": "string",
        "status": "string"
      }
    ],
    "activeMgr": "string"
  },
  "healthDetails": {
    "status": "HEALTH_OK",
    "checks": {}
  },
  "placementGroups": [
    {
      "poolName": "string",
      "poolId": 0,
      "total": 0,
      "okay": 0,
      "warn": 0,
      "error": 0
    }
  ],
  "recoveryTimeRemaining": 0,
  "servers": {
    "healthy": true,
    "online": 0,
    "total": 0
  },
  "mds": {
    "online": 0,
    "total": 0,
    "up": 0
  },
  "utilizationByDeviceClass": {},
  "radosgws": {
    "healthy": true,
    "online": 0,
    "total": 0
  },
  "iscsi": {
    "healthy": true,
    "online": 0,
    "total": 0
  },
  "nfsGateways": {
    "healthy": true,
    "online": 0,
    "total": 0
  },
  "smbGateways": {
    "healthy": true,
    "online": 0,
    "total": 0
  },
  "licenseActive": true,
  "licenseValidUntil": 0,
  "croitUptime": 0
}
                  

GET /cluster/status/detail

Parameters

No parameters...

Endpoint

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

Response 200

status
string
optional
[HEALTH_OK, HEALTH_WARN, HEALTH_ERR, HEALTH_UNKNOWN]
checks
object
optional
-

Example response

{
  "status": "HEALTH_OK",
  "checks": {}
}
                  

GET /cluster/status/nagios

Parameters

No parameters...

Endpoint

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

Response 200

Example response

"string"
                  

GET /cluster/status/nagios/{check}

Parameters

check
string
path
-

Endpoint

curl -X GET http://mgmt-node:8080/api/cluster/status/nagios/{check}
                

Response 200

Example response

"string"