Onedata API Reference

REST API references for Onezone, Oneprovider, and Onepanel.

Add zone cluster managers

POST /zone/managers

Deploys a cluster manager service on provided hosts.

Request body

application/json

The hosts specification where cluster managers should be deployed.

PropertyType & Description
mainHost
string

The main cluster manager host. Main cluster manager node is responsible for monitoring cluster worker nodes. Other nodes, which are redundant, are suspended. In case of main cluster manager node failure one of redundant nodes is resumed and takes over main node responsibilities.

hosts
array of strings

The list of service hosts.

Request Examples

application/json
{
  "mainHost": "node1.example.com",
  "hosts": [
    "node1.example.com",
    "node2.example.com",
    "node3.example.com"
  ]
}

Responses

application/json
202
No description.
400

Invalid request.

PropertyType & Description
error
object

Object describing an error.

id required
string

String identifying the error type. Does not change between error instances.

description required
string

Human readable error description. May contain information specific to given error instance.

details
object

Details about the error instance. The object schema is specific to each error type.

Example

application/json
{
  "error": {
    "id": "badValueString",
    "details": {
      "key": "name"
    },
    "description": "Bad value: provided \"name\" must be a string."
  }
}
401

Unauthorized request.

403

Forbidden request.

500

Internal server error.

PropertyType & Description
error
object

Object describing an error.

id required
string

String identifying the error type. Does not change between error instances.

description required
string

Human readable error description. May contain information specific to given error instance.

details
object

Details about the error instance. The object schema is specific to each error type.

Example

application/json
{
  "error": {
    "id": "badValueString",
    "details": {
      "key": "name"
    },
    "description": "Bad value: provided \"name\" must be a string."
  }
}