Onedata API Reference

REST API references for Onezone, Oneprovider, and Onepanel.

Onezone REST API Oneprovider REST API Onepanel REST API

Get provider cluster configuration

GET /provider/configuration

Returns the provider cluster configuration.

Request Examples

Shell
onepanel-rest-cli -u onepanel:$PASSPHRASE getProviderConfiguration --host https://$OP_PANEL_HOST:9443

Responses

application/json
200

The provider cluster configuration.

Property
Type & Description
cluster
object (ProviderClusterConfigurationDetails)

The provider cluster configuration.
master required
string

Host responsible for deploying cluster and coordinating cluster restarts.

hosts required
array of strings

List of hosts belonging to the Onepanel cluster.

databases required
object (DatabaseHosts)

The cluster database service hosts configuration.
hosts required
array of strings

The list of service hosts.

managers required
object (ManagerHosts)

The cluster manager service hosts configuration.
mainHost required
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 required
array of strings

The list of service hosts.

oneS3 required
object (OneS3Hosts)

The OneS3 service hosts configuration.
hosts required
array of strings

The list of service hosts.

port required
integer

The port on which the OneS3 service is available.

workers required
object (WorkerHosts)

The cluster worker service hosts configuration.
hosts required
array of strings

The list of service hosts.

oneprovider
object

The provider custom configuration.
name required
string

The name of a provider. null if not registered.

configured required
boolean

True if all steps of cluster deployment and configuration have been performed.

Example

application/json
{
  "cluster": {
    "master": "node1.oneprovider.onedata.example.com",
    "managers": {
      "mainHost": "node1.oneprovider.onedata.example.com",
      "hosts": [
        "node1.oneprovider.onedata.example.com"
      ]
    },
    "workers": {
      "hosts": [
        "node1.oneprovider.onedata.example.com"
      ]
    },
    "oneS3": {
      "hosts": [
        "node1.oneprovider.onedata.example.com"
      ]
    },
    "databases": {
      "hosts": [
        "node1.oneprovider.onedata.example.com"
      ]
    }
  },
  "oneprovider": {
    "name": "example",
    "configured": true
  }
}
401

Unauthorized request.

403

Forbidden request.

404

Cluster is not fully deployed.

500

Internal server error.

Property
Type & Description
error
object (ErrorDetails)

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."
  }
}