# ha-groups

Manage high availability groups and floating IPs.
Set management node URL:

# PUT /servers/ha-groups/{id}

# Parameters

  • idinteger-
  • bodyobject-
    • idinteger-
    • descriptionstring-
    • virtualIpstring-
    • servicestring[nfs, rgw]
    • serversarray-
      • serverinteger-
      • nicinteger-
      • vlaninteger-
    • failbackbooleanSwitch back to the original server after it recovers.
    • failoverTimeintegerTime in seconds until a failover is triggered after a fault state is detected.
    • failbackTimeintegerTime in seconds until the service fails back to the original server after it recovers.
    • evictNfsClientsOnFailbackbooleanForce disconnect NFS clients from a secondary when failing back to a recovering master server.

# Endpoint

curl -X PUT http://mgmt-node:8080/api/servers/ha-groups/{id} 

# Example body

{
  "id": 0,
  "description": "string",
  "virtualIp": "string",
  "service": "nfs",
  "servers": [
    {
      "server": 0,
      "nic": 0,
      "vlan": 0
    }
  ],
  "failback": true,
  "failoverTime": 0,
  "failbackTime": 0,
  "evictNfsClientsOnFailback": true
}

# DELETE /servers/ha-groups/{id}

# Parameters

  • idinteger-

# Endpoint

curl -X DELETE http://mgmt-node:8080/api/servers/ha-groups/{id} 

# GET /servers/ha-groups

# Parameters

  • No parameters...

# Endpoint

curl -X GET http://mgmt-node:8080/api/servers/ha-groups 

# Response 200

  • idinteger-
  • descriptionstring-
  • virtualIpstring-
  • servicestring[nfs, rgw]
  • serversarray-
    • serverinteger-
    • nicinteger-
    • vlaninteger-
  • failbackbooleanSwitch back to the original server after it recovers.
  • failoverTimeintegerTime in seconds until a failover is triggered after a fault state is detected.
  • failbackTimeintegerTime in seconds until the service fails back to the original server after it recovers.
  • evictNfsClientsOnFailbackbooleanForce disconnect NFS clients from a secondary when failing back to a recovering master server.

# Example response

[
  {
    "id": 0,
    "description": "string",
    "virtualIp": "string",
    "service": "nfs",
    "servers": [
      {
        "server": 0,
        "nic": 0,
        "vlan": 0
      }
    ],
    "failback": true,
    "failoverTime": 0,
    "failbackTime": 0,
    "evictNfsClientsOnFailback": true
  }
]

# POST /servers/ha-groups

# Parameters

  • bodyobject-
    • idinteger-
    • descriptionstring-
    • virtualIpstring-
    • servicestring[nfs, rgw]
    • serversarray-
      • serverinteger-
      • nicinteger-
      • vlaninteger-
    • failbackbooleanSwitch back to the original server after it recovers.
    • failoverTimeintegerTime in seconds until a failover is triggered after a fault state is detected.
    • failbackTimeintegerTime in seconds until the service fails back to the original server after it recovers.
    • evictNfsClientsOnFailbackbooleanForce disconnect NFS clients from a secondary when failing back to a recovering master server.

# Endpoint

curl -X POST http://mgmt-node:8080/api/servers/ha-groups 

# Example body

{
  "id": 0,
  "description": "string",
  "virtualIp": "string",
  "service": "nfs",
  "servers": [
    {
      "server": 0,
      "nic": 0,
      "vlan": 0
    }
  ],
  "failback": true,
  "failoverTime": 0,
  "failbackTime": 0,
  "evictNfsClientsOnFailback": true
}